Agent 코딩에서 Spring Data JPA vs MyBatis 선택에 대한 생각

최근 Agent 기반 코딩이나 AI 자동화 시스템을 개발하면서 데이터 접근 계층을 어떻게 구성할지에 대한 고민이 많아지고 있습니다. 특히 Spring 환경에서 Spring Data JPA를 사용할지, 아니면 MyBatis처럼 SQL을 직접 제어하는 방식을 사용할지에 대한 선택은 프로젝트 성격에 따라 중요한 설계 포인트가 됩니다.

결론부터 말하면 “무조건 JPA가 정답”도 아니고, “MyBatis가 더 낫다”도 아닙니다. Agent 코딩이라는 특수한 상황에서는 오히려 접근 방식 자체를 다시 생각해볼 필요가 있습니다.

1. Spring Data JPA의 장점과 한계

Spring Data JPA는 객체 중심 개발에 최적화된 ORM 방식입니다.

장점

• 도메인 중심 개발 가능 (객체 모델 중심)
• CRUD 개발 속도 빠름
• 변경 감지(Dirty Checking) 지원
• DB 독립성 확보

이러한 특징 때문에 일반적인 비즈니스 서비스에서는 생산성이 매우 높습니다.

하지만 Agent 코딩에서는 한계가 생깁니다

Agent 시스템의 특징은 다음과 같습니다.

• 동적 쿼리 생성이 많음
• 다양한 조건 조합이 실시간으로 발생
• AI가 생성한 구조를 그대로 DB에 반영해야 하는 경우 존재
• 성능 튜닝이 중요한 경우 많음

이런 환경에서는 JPA가 오히려 복잡해지는 경우가 있습니다.

JPA의 단점

• 복잡한 쿼리 작성 시 가독성 저하
• N+1 문제 관리 필요
• 예상 SQL이 눈에 보이지 않음
• AI가 생성한 동적 쿼리 대응이 어려움

즉, “추상화된 편리함”이 오히려 “제어력 부족”으로 이어질 수 있습니다.

2. MyBatis (Native Query 방식)의 장점

MyBatis는 SQL을 직접 작성하는 방식이기 때문에 구조가 단순합니다.

장점

• SQL이 명확하게 보임
• 복잡한 쿼리 제어가 쉬움
• 성능 튜닝이 직관적
• AI 기반 코드 생성과 궁합이 좋음

특히 Agent 시스템에서는 이 부분이 매우 중요합니다.

Agent 코딩과의 궁합

Agent는 보통 다음과 같은 작업을 수행합니다.

• 자연어 → SQL 변환
• 동적 조건 생성
• 복잡한 필터링 로직 구성

이때 MyBatis 구조는 AI가 생성한 SQL을 그대로 적용하기 쉽고, 디버깅도 직관적입니다.

3. Agent 코딩 관점에서의 핵심 차이

Agent 시스템에서는 “개발 생산성”보다 “제어 가능성”이 더 중요해지는 경우가 많습니다.

항목JPAMyBatis

4. 개인적인 결론 (Agent 코딩 기준)

Agent 기반 시스템을 개발하면서 느낀 핵심은 다음과 같습니다.

1) 단순 CRUD 중심이면 JPA가 여전히 좋다

• 빠르게 개발 가능
• 구조가 단순함
• 유지보수 쉬움

2) 하지만 Agent 시스템에서는 MyBatis가 더 유리한 경우가 많다

• SQL을 AI가 직접 생성/제어하기 쉬움
• 디버깅이 직관적
• 성능 튜닝이 명확함

5. 현실적인 추천 구조

Agent 코딩에서 가장 좋은 구조는 “하나만 선택”이 아니라 혼합 전략입니다.

추천 방식

• 단순 도메인 → JPA 사용
• 복잡한 분석/검색/동적 쿼리 → MyBatis 사용
• AI 생성 쿼리 → MyBatis 중심

결론

Spring Data JPA는 여전히 강력한 도구지만, Agent 기반 개발에서는 “추상화된 편리함”이 항상 정답이 되지는 않습니다.

오히려 MyBatis처럼 SQL이 명확하게 보이는 구조가 AI와 함께 사용할 때 더 자연스럽고, 제어하기 쉬운 경우가 많습니다.

결국 중요한 것은 “프레임워크 선택”이 아니라
“AI가 개입하는 구조에서 얼마나 예측 가능하게 시스템을 설계할 수 있는가”입니다.

javax.validation을 이용해서 date형태의 날짜를 validation을 할 때 정규표현식을 이용할 수 있음

날짜가 문자열일 때 ( yyyy-mm-dd)

@Pattern(regexp ="^\\d{4}\\-(0[1-9]|1[012])\\-(0[1-9]|[12][0-9]|3[01])$",message = "eventDt는 yyyy-mm-dd 형식:2022=10-09과 일치해야 합니다.")
private String eventDt;

\d{4}\-(0?[1-9]|1[012])\-(0?[1-9]|[12][0-9]|3[01])*

등을 이용해서 검증할 수 있음.

timestamp값을 아래와 같이 사용하려면 .

{
  "statusCode": 404,
  "timestamp": "2022-11-24T14:32:53.553594",
  "message": "이벤트가 존재하지 않습니다."
}

1.해당 변수에 @DateTimeFormat annotation을 달고 직접 pattern을 설정합니다.

public class ErrorMessage {
    private int statusCode;
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime timestamp;
    private String message;

    public ErrorMessage(int statusCode, String message) {
        this.statusCode = statusCode;
        this.timestamp = LocalDateTime.now();
        this.message = message;
    }

    public int getStatusCode() {
        return statusCode;
    }

    public LocalDateTime getTimestamp() {
        return timestamp;
    }

    public String getMessage() {
        return message;
    }
}

2.application.properties에 jackson  serialization중 WRITE_DATES_AS_TIMESTAMPS 값을 false로  설정합니다.  

spring.jackson.serialization.WRITE_DATES_AS_TIMESTAMPS=false

기본 format 형태로 출력됩니다. 전체적으로 날짜 포멧이 아래와 같다면... .. 2번 방법으로.. 사용...

yyyy-MM-dd'T'HH:mm:ss