[Spring Boot + JPA] Excepiton 발생시 DB에 저장하는 방법 예제 코드 by chatGPT

관리자

다음 예제 코드는 Spring Boot + JPA + 전역 예외 처리 + 분리 트랜잭션 + DB 저장 하는 예제 코드입니다.
WAS서버에 로그파일로(logback) 매일 백엔드 처리 관련 로그를 남기도 있는데,
개인정보 보안 이슈에 따라, 그 어떤 개인정보도 남으면 안된다는 방침 때문에 DB저장하는 것으로 처리를 진행하게 되었습니다. 로그백에서 로그 처리 단위를 ERROR로 해도 될까 했으나, 안된다고 하니……….참…………

아래 내용대로 테스트해도 되지만, 파일 생성하기전에 “@RestControllerAdvice” 어노테이션을 소스 코드에서 찾아보세요. 만약 존재한다면, 그안에 저장하는 로직만 호출해주면 처리됩니다.

저의 경우, ErrorLog.java, ErrorLogRepository.java, ErrorLogService.java 파일만 추가 후 DB에 테이블 생성 후 정상 처리됨을 확인하였습니다.

chatGPT :

Interceptor / Filter / AOP / @ControllerAdvice 중에서 목적에 가장 맞는 방법은 보통
👉 @ControllerAdvice + ExceptionHandler 방식이 가장 깔끔하고 안정적입니다.
(Interceptor는 Exception 캐치에 구조적으로 불리함)

아래에서 실무 기준으로 정리해 드릴게요.

Interceptor로 예외 저장이 비추천인 이유

HandlerInterceptor의 afterCompletion() 은:

정상 응답 / 예외 모두 호출됨
하지만 Exception 객체가 null 인 경우가 많음
Spring 예외 처리 흐름 이후라 정보가 불완전
트랜잭션 컨텍스트 분리됨

→ 실무에서는 전역 예외 핸들러가 정석

✅ 권장 구조

Controller → Service → Exception 발생
         ↓
@ControllerAdvice 에서 캐치
         ↓
DB 저장
         ↓
응답 반환

✅ 1. 오류 저장 테이블 예시

CREATE TABLE TB_ERROR_LOG (
    ID BIGSERIAL PRIMARY KEY,
    ERROR_TYPE VARCHAR(100),
    MESSAGE TEXT,
    STACK_TRACE TEXT,
    REQUEST_URI VARCHAR(500),
    METHOD VARCHAR(10),
    IP VARCHAR(50),
    CREATED_AT TIMESTAMP DEFAULT now()
);

✅ 2. Entity

@Entity
@Table(name="TB_ERROR_LOG")
@Getter @Setter
public class ErrorLog {

    @Id @GeneratedValue
    private Long id;

    private String errorType;
    private String message;

    @Column(columnDefinition="TEXT")
    private String stackTrace;

    private String requestUri;
    private String method;
    private String ip;

    private LocalDateTime createdAt = LocalDateTime.now();
}

✅ 3. Repository

public interface ErrorLogRepository extends JpaRepository<ErrorLog, Long> {
}

✅ 4. 전역 예외 처리기

@Slf4j
@ControllerAdvice
@RequiredArgsConstructor
public class GlobalExceptionHandler {

    private final ErrorLogRepository errorLogRepository;

    @ExceptionHandler(Exception.class)
    public ResponseEntity<?> handleException(
            Exception e,
            HttpServletRequest request) {

        ErrorLog log = new ErrorLog();
        log.setErrorType(e.getClass().getName());
        log.setMessage(e.getMessage());
        log.setStackTrace(getStackTrace(e));
        log.setRequestUri(request.getRequestURI());
        log.setMethod(request.getMethod());
        log.setIp(request.getRemoteAddr());

        errorLogRepository.save(log);

        return ResponseEntity
                .status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body("서버 오류가 발생했습니다.");
    }

    private String getStackTrace(Exception e) {
        StringWriter sw = new StringWriter();
        e.printStackTrace(new PrintWriter(sw));
        return sw.toString();
    }
}

✅ 5. 트랜잭션 깨짐 방지 (중요)

서비스 로직 트랜잭션이 롤백되면
에러 로그도 같이 롤백됩니다.

👉 분리 트랜잭션 권장

@Transactional(propagation = Propagation.REQUIRES_NEW)
public void save(ErrorLog log){
    errorLogRepository.save(log);
}

그리고 Handler에서는 이 메서드만 호출.

✅ Interceptor로 한다면?

가능은 하지만 권장 X

@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response,
                            Object handler, Exception ex) {
    if(ex != null){
        // DB 저장
    }
}

단:

RestController 예외는 대부분 여기까지 안 옴
Spring ExceptionResolver에서 처리됨
정보 누락 빈번

🎯 실무 추천 조합

목적	방식
예외 DB 저장	@ControllerAdvice
요청/응답 로그	Filter
메서드 단위	AOP

🔥 Logback 완전 대체 가능?

실무에서는 보통:

logback → 파일
DB → 주요 예외만

이중 구조 권장합니다.

✨ 원하시면

특정 Exception만 DB 저장
4xx / 5xx 분리
사용자 ID 포함
API 별 그룹핑
비동기 저장 구조
대용량 처리 구조

전부 실무 구조로 예제 만들어 드릴 수 있습니다.

필요하시면
👉 “비동기로 DB 저장하게 구성해줘”
👉 “특정 Exception만 저장하고 싶어”
👉 “MyBatis로 저장하는 예제”

원하시는 방식 알려주세요.

전체 코드를 다 줘

좋아요.
👉 Spring Boot + JPA + 전역 예외 처리 + 분리 트랜잭션 + DB 저장
👉 실무에서 그대로 쓰는 완성형 구조를 한 세트로 드리겠습니다.

✅ 전체 구조

exception/
 └ GlobalExceptionHandler.java
entity/
 └ ErrorLog.java
repository/
 └ ErrorLogRepository.java
service/
 └ ErrorLogService.java

✅ 1. DB 테이블

CREATE TABLE TB_ERROR_LOG (
    ID BIGSERIAL PRIMARY KEY,
    ERROR_TYPE VARCHAR(200),
    MESSAGE TEXT,
    STACK_TRACE TEXT,
    REQUEST_URI VARCHAR(500),
    METHOD VARCHAR(20),
    IP VARCHAR(50),
    CREATED_AT TIMESTAMP DEFAULT now()
);

✅ 2. Entity

package com.example.entity;

import jakarta.persistence.*;
import lombok.*;

import java.time.LocalDateTime;

@Entity
@Table(name = "TB_ERROR_LOG")
@Getter @Setter
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class ErrorLog {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String errorType;

    @Column(columnDefinition = "TEXT")
    private String message;

    @Column(columnDefinition = "TEXT")
    private String stackTrace;

    private String requestUri;
    private String method;
    private String ip;

    private LocalDateTime createdAt = LocalDateTime.now();
}

✅ 3. Repository

package com.example.repository;

import com.example.entity.ErrorLog;
import org.springframework.data.jpa.repository.JpaRepository;

public interface ErrorLogRepository extends JpaRepository<ErrorLog, Long> {
}

✅ 4. Service (트랜잭션 분리 핵심)

package com.example.service;

import com.example.entity.ErrorLog;
import com.example.repository.ErrorLogRepository;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Propagation;
import org.springframework.transaction.annotation.Transactional;

@Service
@RequiredArgsConstructor
public class ErrorLogService {

    private final ErrorLogRepository repository;

    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void save(ErrorLog log){
        repository.save(log);
    }
}

✅ 5. Global Exception Handler (핵심)

package com.example.exception;

import com.example.entity.ErrorLog;
import com.example.service.ErrorLogService;
import jakarta.servlet.http.HttpServletRequest;
import lombok.RequiredArgsConstructor;
import org.springframework.http.*;
import org.springframework.web.bind.annotation.*;

import java.io.PrintWriter;
import java.io.StringWriter;

@ControllerAdvice
@RequiredArgsConstructor
public class GlobalExceptionHandler {

    private final ErrorLogService errorLogService;

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(
            Exception e,
            HttpServletRequest request) {

        ErrorLog log = ErrorLog.builder()
                .errorType(e.getClass().getName())
                .message(e.getMessage())
                .stackTrace(getStackTrace(e))
                .requestUri(request.getRequestURI())
                .method(request.getMethod())
                .ip(request.getRemoteAddr())
                .build();

        errorLogService.save(log);

        return ResponseEntity
                .status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body("서버 오류가 발생했습니다.");
    }

    private String getStackTrace(Exception e){
        StringWriter sw = new StringWriter();
        e.printStackTrace(new PrintWriter(sw));
        return sw.toString();
    }
}

✅ 6. 테스트용 컨트롤러

@RestController
@RequestMapping("/test")
public class TestController {

    @GetMapping("/error")
    public String error(){
        int a = 1 / 0;
        return "ok";
    }
}

✅ 7. 결과

요청:

GET /test/error

DB 저장:

error_type	message	stack_trace	request_uri
java.lang.ArithmeticException	/ by zero	stack trace	/test/error

✅ 8. 특정 Exception만 저장하려면

@ExceptionHandler(RuntimeException.class)

또는

if(e instanceof SQLException)

✅ 9. 비동기로 바꾸고 싶으면 (선택)

@Async
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void save(ErrorLog log)

그리고

@EnableAsync

🎯 이 구조의 장점

항목	이유
로그 누락 없음	Spring 처리 전 캐치
트랜잭션 안전	로그는 항상 저장
logback 대체 가능	DB 기준 관리
확장 쉬움	사용자ID, API명 추가 가능

🔥 원하시면 더 확장 가능

사용자 로그인 ID 포함
Request Body 저장
Header 저장
API 그룹별 집계
관리자 화면용 조회 쿼리
MyBatis 버전
MongoDB 버전

원하시면
👉 “MyBatis 버전으로 다시 만들어줘”
👉 “비동기 + 큐 방식으로 구성해줘”
👉 “사용자 정보 포함 구조로”

말해주시면 그 구조로 바로 만들어 드리겠습니다.

비동기 “MyBatis 버전으로 다시 만들어줘”

좋습니다.
👉 Spring Boot + MyBatis + 전역 예외 처리 + 비동기 + 분리 트랜잭션 + DB 저장
👉 실무에서 바로 쓰는 완성형 풀세트 드립니다.

✅ 구조

exception/
 └ GlobalExceptionHandler.java
dto/
 └ ErrorLogDto.java
mapper/
 └ ErrorLogMapper.java
 └ ErrorLogMapper.xml
service/
 └ ErrorLogService.java
config/
 └ AsyncConfig.java

✅ 1. 테이블

CREATE TABLE TB_ERROR_LOG (
    ID BIGSERIAL PRIMARY KEY,
    ERROR_TYPE VARCHAR(200),
    MESSAGE TEXT,
    STACK_TRACE TEXT,
    REQUEST_URI VARCHAR(500),
    METHOD VARCHAR(20),
    IP VARCHAR(50),
    CREATED_AT TIMESTAMP DEFAULT now()
);

✅ 2. DTO

package com.example.dto;

import lombok.*;

import java.time.LocalDateTime;

@Getter @Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class ErrorLogDto {

    private Long id;
    private String errorType;
    private String message;
    private String stackTrace;
    private String requestUri;
    private String method;
    private String ip;
    private LocalDateTime createdAt;
}

✅ 3. Mapper Interface

package com.example.mapper;

import com.example.dto.ErrorLogDto;
import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface ErrorLogMapper {

    void insertErrorLog(ErrorLogDto dto);
}

✅ 4. Mapper XML

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

<mapper namespace="com.example.mapper.ErrorLogMapper">

    <insert id="insertErrorLog" parameterType="com.example.dto.ErrorLogDto">
        INSERT INTO TB_ERROR_LOG
        (ERROR_TYPE, MESSAGE, STACK_TRACE, REQUEST_URI, METHOD, IP, CREATED_AT)
        VALUES
        (#{errorType}, #{message}, #{stackTrace},
         #{requestUri}, #{method}, #{ip}, now())
    </insert>

</mapper>

✅ 5. Async Config

package com.example.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableAsync;

@Configuration
@EnableAsync
public class AsyncConfig {
}

✅ 6. Service (비동기 + 트랜잭션 분리 핵심)

package com.example.service;

import com.example.dto.ErrorLogDto;
import com.example.mapper.ErrorLogMapper;
import lombok.RequiredArgsConstructor;
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Propagation;
import org.springframework.transaction.annotation.Transactional;

@Service
@RequiredArgsConstructor
public class ErrorLogService {

    private final ErrorLogMapper mapper;

    @Async
    @Transactional(propagation = Propagation.REQUIRES_NEW)
    public void saveAsync(ErrorLogDto dto){
        mapper.insertErrorLog(dto);
    }
}

✅ 7. Global Exception Handler

package com.example.exception;

import com.example.dto.ErrorLogDto;
import com.example.service.ErrorLogService;
import jakarta.servlet.http.HttpServletRequest;
import lombok.RequiredArgsConstructor;
import org.springframework.http.*;
import org.springframework.web.bind.annotation.*;

import java.io.PrintWriter;
import java.io.StringWriter;

@ControllerAdvice
@RequiredArgsConstructor
public class GlobalExceptionHandler {

    private final ErrorLogService errorLogService;

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(
            Exception e,
            HttpServletRequest request) {

        ErrorLogDto dto = ErrorLogDto.builder()
                .errorType(e.getClass().getName())
                .message(e.getMessage())
                .stackTrace(getStackTrace(e))
                .requestUri(request.getRequestURI())
                .method(request.getMethod())
                .ip(request.getRemoteAddr())
                .build();

        // 비동기 DB 저장
        errorLogService.saveAsync(dto);

        return ResponseEntity
                .status(HttpStatus.INTERNAL_SERVER_ERROR)
                .body("서버 오류가 발생했습니다.");
    }

    private String getStackTrace(Exception e){
        StringWriter sw = new StringWriter();
        e.printStackTrace(new PrintWriter(sw));
        return sw.toString();
    }
}

✅ 8. MyBatis 설정 (application.yml)

mybatis:
  mapper-locations: classpath:mapper/*.xml
  type-aliases-package: com.example.dto

✅ 9. 테스트

@GetMapping("/error")
public String test(){
    int a = 1 / 0;
    return "ok";
}

✅ 10. 동작 흐름

Exception 발생
 → ControllerAdvice 캐치
 → 비동기 스레드로 DB 저장
 → 원래 트랜잭션 영향 없음
 → 응답 즉시 반환

🎯 이 구조의 실무 장점

항목	효과
비동기	응답 지연 없음
REQUIRES_NEW	로그 롤백 방지
MyBatis	SQL 완전 제어
DB 로그	중앙 관리

원하시면 다음 단계로
👉 “Request Body까지 저장하는 구조”
👉 “Spring Security 사용자 ID 포함”
👉 “에러 로그 관리자 조회 SQL”
👉 “Logback + DB 동시 저장 구조”

전부 실무 기준으로 만들어 드릴 수 있습니다.

@Async @Transactional(propagation = Propagation.REQUIRES_NEW) public void save(ErrorLog log) 위처럼 했어. .근데 @EnableAsync이건 어디에 넣으라는거야?

아주 좋은 질문입니다.
여기서 많은 사람들이 헷갈립니다.

결론부터 말하면:

👉 @EnableAsync 는 Spring Boot 메인 클래스 또는 Config 클래스에 딱 한 번만 넣으면 됩니다.

✅ 가장 권장 위치 (메인 클래스)

@SpringBootApplication
@EnableAsync
public class MyApplication {

    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

이게 정석 + 가장 안정적입니다.

✅ 또는 Config 클래스

@Configuration
@EnableAsync
public class AsyncConfig {
}

둘 중 하나만 있으면 됩니다.
❌ 둘 다 넣으면 안 됩니다.

⚠️ 꼭 알아야 할 중요한 점

1️⃣ 반드시 Spring Bean 이어야 Async 적용됨

@Service
public class ErrorLogService {

2️⃣ 자기 자신 호출하면 Async 안 됨 ❌

this.save(log);  // Async 안 먹힘

반드시 다른 Bean에서 호출해야 합니다.

3️⃣ private 메서드는 Async 안 먹힘 ❌

@Async
private void save() ❌

4️⃣ 인터페이스 기반 프록시 주의

기본 설정은 CGLIB이라 괜찮지만,
혹시 proxyTargetClass=false 면 interface 호출해야 Async 동작.

✅ 정상 동작 확인 방법

로그 찍어보면 스레드명이 다릅니다.

log.info("thread = {}", Thread.currentThread().getName());

결과:

http-nio-8080-exec-1
task-1

✅ 지금 구조 정리

위치	설정
메인 클래스	@EnableAsync
서비스 메서드	@Async
메서드	public
호출	다른 Bean에서

🔥 실무 권장 추가 설정 (스레드 풀)

기본 Async는 성능이 안 좋습니다.
실무용으로 꼭 바꾸세요.

@Configuration
@EnableAsync
public class AsyncConfig implements AsyncConfigurer {

    @Override
    public Executor getAsyncExecutor() {
        ThreadPoolTaskExecutor ex = new ThreadPoolTaskExecutor();
        ex.setCorePoolSize(5);
        ex.setMaxPoolSize(20);
        ex.setQueueCapacity(100);
        ex.setThreadNamePrefix("ERROR-ASYNC-");
        ex.initialize();
        return ex;
    }
}

🎯 정리

@EnableAsync 는
✔ 메인 클래스 또는 Config 클래스
✔ 한 번만
✔ Bean으로 등록

원하시면
👉 Async 안 먹힐 때 체크리스트
👉 Async + Transaction 같이 쓸 때 주의점
👉 Async 예외 처리 방법

도 전부 정리해 드릴 수 있습니다.

@GetMapping(“/error”) 호출해서 오류가 발생했는데, 데이터가 안쌓여… 나 완전 초보야 어떻게 하는지 알려줘야해 GlobalExceptionHandler 를 안타는것 같은데

아… 지금 상황 딱 보니까 초보자들이 100% 한 번은 겪는 함정에 걸리셨어요.

👉 /error URL 자체가 Spring Boot 기본 에러 컨트롤러 경로입니다.
그래서 당신의 컨트롤러 + GlobalExceptionHandler 자체가 아예 실행이 안 됩니다.

이게 핵심 원인입니다. 🔥

🚨 왜 안 되는지

Spring Boot는 내부적으로

/error  → BasicErrorController

를 이미 등록해 두었습니다.

그래서

@GetMapping("/error")

는 당신 컨트롤러가 아니라 Spring 내부 컨트롤러가 먼저 처리합니다.

→ 그래서 예외가 GlobalExceptionHandler로 안 갑니다.

✅ 해결 방법 (무조건 바꾸세요)

❌ 잘못된 테스트

@GetMapping("/error")

✅ 이렇게 바꾸세요

@GetMapping("/test-error")

✅ 올바른 테스트 컨트롤러

@RestController
public class TestController {

    @GetMapping("/test-error")
    public String test(){
        int a = 1 / 0;
        return "ok";
    }
}

✅ GlobalExceptionHandler도 정확히 이렇게

@RestControllerAdvice
@RequiredArgsConstructor
public class GlobalExceptionHandler {

    private final ErrorLogService errorLogService;

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handle(Exception e, HttpServletRequest request){

        ErrorLog log = ErrorLog.builder()
                .errorType(e.getClass().getName())
                .message(e.getMessage())
                .requestUri(request.getRequestURI())
                .build();

        errorLogService.save(log);

        return ResponseEntity.status(500).body("에러 발생");
    }
}

⚠️ @ControllerAdvice 말고 @RestControllerAdvice 권장

✅ 그리고 반드시 확인

1️⃣ 패키지 위치

com.example
 ├ controller
 ├ exception   ← GlobalExceptionHandler
 ├ service

@SpringBootApplication 이 있는 패키지 하위에 있어야 합니다.

2️⃣ @EnableAsync

@SpringBootApplication
@EnableAsync
public class Application {}

3️⃣ Async 메서드는 public

@Async
@Transactional(propagation = Propagation.REQUIRES_NEW)
public void save(ErrorLog log)

✅ 지금 이대로 하면 100% 됩니다

URL /test-error 로 호출
500 응답
DB 저장됨

🔥 만약 그래도 안 되면

아래 3가지만 확인해서 알려주세요:

1️⃣ TestController 코드
2️⃣ GlobalExceptionHandler 코드
3️⃣ ErrorLogService 코드

제가 그대로 보고 어디서 막히는지 정확히 찝어드릴게요.

🎯 초보자용 요약

문제	원인
/error 호출	Spring 내부 컨트롤러
Handler 안 탐	당연함
DB 안 쌓임	예외 캐치 못함

지금 바로
👉 /test-error 로 바꿔서 호출해보세요.

그 다음 결과 알려주시면 거기서부터 단계별로 같이 잡아드립니다.

에러내용 전체를 저장하고 싶은데.. 아래처럼 하면 의미없는 데이터만 저장돼 private String getStackTrace(Exception e){ StringWriter sw = new StringWriter(); e.printStackTrace(new PrintWriter(sw)); return sw.toString(); }

이 부분은 코드는 맞는데, 저장되는 값이 이상하게 보이는 전형적인 상황입니다.
그리고 초보자가 99% 여기서 막힙니다. 지금부터 왜 그런지 + 정확한 해결 방법을 단계별로 알려드릴게요.

✅ 결론부터

e.printStackTrace(new PrintWriter(sw));

👉 이 코드는 정상입니다.

그런데 DB에

한 줄만 저장된다
의미 없는 문자만 저장된다
Exception 이름만 나온다
stacktrace 가 잘린다

이 현상은 DB 컬럼 타입 / MyBatis 매핑 / 인코딩 문제 때문입니다.

🚨 가장 흔한 원인 TOP 3

1️⃣ DB 컬럼 길이 부족

STACK_TRACE TEXT

아니면

STACK_TRACE VARCHAR(4000) ❌

이면 무조건 잘립니다.

👉 PostgreSQL / MySQL 모두 TEXT / CLOB 써야 합니다.

2️⃣ MyBatis XML 매핑 문제

#{stackTrace}

이렇게 되어 있어야 합니다.

DTO 필드명이:

private String stackTrace;

이면 XML도 정확히 동일해야 합니다.

3️⃣ 실제로 저장되는 값 확인 안 함

Handler에서 반드시 한번 찍어보세요:

String trace = getStackTrace(e);
System.out.println(trace);

여기서 정상인데 DB가 이상하면 → DB 문제
여기서부터 이상하면 → 코드 문제

✅ 실무에서 쓰는 “완전한” StackTrace 추출 코드

지금 코드보다 이게 더 안정적입니다.

private String getStackTrace(Exception e) {
    StringWriter sw = new StringWriter();
    PrintWriter pw = new PrintWriter(sw);
    e.printStackTrace(pw);
    return sw.toString();
}

이건 동일하지만 PrintWriter close 안 해도 됨.

✅ 더 좋은 방식 (Apache Commons)

실무에서는 이걸 씁니다:

import org.apache.commons.lang3.exception.ExceptionUtils;

private String getStackTrace(Exception e){
    return ExceptionUtils.getStackTrace(e);
}

👉 훨씬 안전 + cause chain 까지 포함됨

✅ 원인 체인까지 포함한 완전판

private String getStackTrace(Throwable e) {
    StringWriter sw = new StringWriter();
    PrintWriter pw = new PrintWriter(sw);

    while (e != null) {
        e.printStackTrace(pw);
        e = e.getCause();
        if (e != null) {
            pw.println("Caused by:");
        }
    }
    return sw.toString();
}

✅ DB에 이렇게 저장됩니다

java.lang.ArithmeticException: / by zero
    at com.example.TestController.test(TestController.java:15)
    at ...
Caused by:
...

로그인id랑 , request 파라미터도 저장할수 있어??

가능합니다.
그리고 실무에서는 반드시 같이 저장합니다.
(로그인ID + 요청 파라미터 없으면 나중에 장애 원인 추적 거의 불가능합니다)

아주 초보 기준으로 하나씩 붙여드릴게요.

✅ 1. DB 컬럼 추가

ALTER TABLE TB_ERROR_LOG
ADD COLUMN LOGIN_ID VARCHAR(100),
ADD COLUMN REQUEST_PARAM TEXT;

✅ 2. DTO 추가

private String loginId;
private String requestParam;

✅ 3. GlobalExceptionHandler에서 값 추출

@RestControllerAdvice
@RequiredArgsConstructor
public class GlobalExceptionHandler {

    private final ErrorLogService errorLogService;

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handle(Exception e, HttpServletRequest request){

        ErrorLogDto dto = ErrorLogDto.builder()
                .errorType(e.getClass().getName())
                .message(e.getMessage())
                .stackTrace(getStackTrace(e))
                .requestUri(request.getRequestURI())
                .method(request.getMethod())
                .ip(request.getRemoteAddr())
                .loginId(getLoginId())
                .requestParam(getRequestParams(request))
                .build();

        errorLogService.saveAsync(dto);

        return ResponseEntity.status(500).body("에러 발생");
    }

✅ 4. 로그인 ID 가져오는 방법

🔹 Spring Security 사용 중이면

private String getLoginId() {
    try {
        Authentication auth = SecurityContextHolder.getContext().getAuthentication();
        if(auth == null) return null;
        return auth.getName();
    } catch (Exception e) {
        return null;
    }
}

🔹 Security 안 쓰면 (세션 기반)

private String getLoginId(HttpServletRequest request){
    Object id = request.getSession().getAttribute("loginId");
    return id == null ? null : id.toString();
}

✅ 5. Request Parameter 저장

private String getRequestParams(HttpServletRequest request){
    Map<String, String[]> paramMap = request.getParameterMap();

    StringBuilder sb = new StringBuilder();

    paramMap.forEach((key, values) -> {
        sb.append(key).append("=");
        sb.append(Arrays.toString(values));
        sb.append("&");
    });

    return sb.toString();
}

저장 결과:

id=[test01]&page=[1]&size=[20]&

✅ 6. MyBatis XML 수정

<insert id="insertErrorLog">
    INSERT INTO TB_ERROR_LOG
    (ERROR_TYPE, MESSAGE, STACK_TRACE, REQUEST_URI, METHOD, IP, LOGIN_ID, REQUEST_PARAM, CREATED_AT)
    VALUES
    (#{errorType}, #{message}, #{stackTrace},
     #{requestUri}, #{method}, #{ip},
     #{loginId}, #{requestParam}, now())
</insert>

✅ 7. DB 결과 예시

login_id	request_param
test01	id=[test01]&page=[1]

🎯 실무에서 이렇게 활용합니다

항목	이유
login_id	어떤 사용자가 오류냈는지
request_param	어떤 값으로 요청했는지
stack_trace	코드 위치
uri	API

🔥 주의사항

POST JSON Body 는 request.getParameterMap()으로 안 나옵니다.
그건 별도 처리해야 합니다. (원하시면 그 방법도 알려드림)

🎯 초보자 요약

로그인ID + 요청파라미터
→ 에러 재현 가능
→ CS 대응 가능
→ 실무 필수

원하시면 다음 단계로

👉 POST JSON Body 저장하는 방법
👉 Header 값 저장
👉 Spring Security 사용자 객체 전체 저장
👉 에러 로그 관리자 조회 화면 SQL

전부 초보자 기준으로 이어서 만들어 드릴 수 있습니다.

POST JSON Body 저장하는 방법

좋은 질문입니다.
👉 POST JSON Body 저장은 초보자들이 가장 많이 막히는 부분이고,
👉 그냥 request.getInputStream() 하면 이미 읽혀서 null 이 나옵니다.

그래서 Filter로 Body를 미리 복사해서 보관해야 합니다.
아래 그대로 하면 100% 저장됩니다.

✅ 원리

요청 →
 Filter에서 Body 복사 →
 request attribute에 저장 →
 GlobalExceptionHandler에서 꺼내서 DB 저장

✅ 1. Filter 생성 (가장 중요)

@Component
public class RequestBodyCachingFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest request,
                                    HttpServletResponse response,
                                    FilterChain filterChain)
            throws ServletException, IOException {

        ContentCachingRequestWrapper wrappedRequest =
                new ContentCachingRequestWrapper(request);

        filterChain.doFilter(wrappedRequest, response);

        String body = new String(wrappedRequest.getContentAsByteArray(),
                request.getCharacterEncoding() == null
                        ? "UTF-8"
                        : request.getCharacterEncoding());

        request.setAttribute("cachedRequestBody", body);
    }
}

✅ 2. GlobalExceptionHandler에서 Body 가져오기

private String getRequestBody(HttpServletRequest request){
    Object body = request.getAttribute("cachedRequestBody");
    return body == null ? null : body.toString();
}

✅ 3. ErrorLogDto 필드 추가

private String requestBody;

✅ 4. Handler에서 저장

ErrorLogDto dto = ErrorLogDto.builder()
        .errorType(e.getClass().getName())
        .message(e.getMessage())
        .stackTrace(getStackTrace(e))
        .requestUri(request.getRequestURI())
        .method(request.getMethod())
        .requestBody(getRequestBody(request))
        .build();

✅ 5. DB 컬럼 추가

ALTER TABLE TB_ERROR_LOG
ADD COLUMN REQUEST_BODY TEXT;

✅ 6. MyBatis XML 수정

#{requestBody}

✅ 7. 결과

POST 요청:

{
  "userId":"test01",
  "amount":1000
}

DB 저장:

{"userId":"test01","amount":1000}

중요한 주의사항

항목	설명
파일 업로드	Body 저장하면 안 됨
대용량 JSON	길이 제한 필요
비밀번호	마스킹 필요
바이너리	제외

실무용 마스킹 예제

body = body.replaceAll("\"password\":\".*?\"", "\"password\":\"****\"");

초보자 핵심 요약

단계	필요
Filter	Body 복사
Attribute 저장	cachedRequestBody
Handler	attribute 꺼냄
DB	TEXT 컬럼

민감정보 자동 마스킹 필터

아주 중요한 단계까지 오셨습니다.
👉 민감정보 자동 마스킹 필터는 실무에서 반드시 넣어야 하는 보안 필수 기능입니다.

아래 코드는 그대로 복붙해서 쓰면 되는 실무용 완성 버전입니다.

🎯 목표

아래 값들이 자동으로 **** 로 바뀝니다.

{
  "password":"1234",
  "ssn":"900101-1234567",
  "cardNo":"1234-5678-9012-3456",
  "token":"abcd"
}

↓

{
  "password":"****",
  "ssn":"****",
  "cardNo":"****",
  "token":"****"
}

✅ 1. 마스킹 유틸 클래스

public class MaskingUtil {

    private static final String[] SENSITIVE_KEYS = {
            "password", "pwd", "pass",
            "ssn", "jumin",
            "cardNo", "cardNumber",
            "token", "accessToken", "refreshToken"
    };

    public static String mask(String body) {
        if (body == null || body.isEmpty()) return body;

        String result = body;

        for (String key : SENSITIVE_KEYS) {
            result = result.replaceAll(
                "(\"" + key + "\"\\s*:\\s*\")([^\"]+)(\")",
                "$1****$3"
            );
        }

        return result;
    }
}

✅ 2. 기존 RequestBodyCachingFilter 수정

@Component
public class RequestBodyCachingFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest request,
                                    HttpServletResponse response,
                                    FilterChain filterChain)
            throws ServletException, IOException {

        ContentCachingRequestWrapper wrappedRequest =
                new ContentCachingRequestWrapper(request);

        filterChain.doFilter(wrappedRequest, response);

        String body = new String(
                wrappedRequest.getContentAsByteArray(),
                request.getCharacterEncoding() == null
                        ? "UTF-8"
                        : request.getCharacterEncoding()
        );

        // 🔐 마스킹 처리
        body = MaskingUtil.mask(body);

        request.setAttribute("cachedRequestBody", body);
    }
}

✅ 3. 파라미터도 마스킹하고 싶으면

private String getRequestParams(HttpServletRequest request){
    Map<String, String[]> paramMap = request.getParameterMap();

    StringBuilder sb = new StringBuilder();

    paramMap.forEach((key, values) -> {
        if(isSensitive(key)){
            sb.append(key).append("=****&");
        }else{
            sb.append(key).append("=")
              .append(Arrays.toString(values))
              .append("&");
        }
    });

    return sb.toString();
}

private boolean isSensitive(String key){
    return key.toLowerCase().contains("password")
        || key.toLowerCase().contains("token")
        || key.toLowerCase().contains("card");
}

✅ 4. GlobalExceptionHandler에서는 그대로 저장

requestBody = getRequestBody(request)

이미 필터에서 마스킹되어 있음.

✅ 5. DB 저장 결과

{"userId":"test01","password":"****","cardNo":"****"}

🚨 실무 보안 팁

항목	이유
원본 저장 ❌	법적 문제
로그 암호화	권장
마스킹 키 관리	config화
길이 제한	2000자 정도

🔥 확장 (원하시면)

정규식 고도화 (중첩 JSON)
카드번호 1234****3456 패턴
주민번호 앞자리 유지
JSON Parser 기반 마스킹 (Gson/Jackson)
Header 마스킹
Response Body 마스킹

🎯 초보자 요약

Body → Filter에서 읽음
→ MaskingUtil로 마스킹
→ Handler는 그대로 저장

원하시면 다음으로

👉 Response Body 마스킹 저장
👉 Header 마스킹
👉 JSON Parser 기반 정확한 마스킹 방식
👉 관리자 조회 화면 SQL

계속 이어서 실무 구조로 만들어 드릴게요.

Hi, I’m 관리자

All My Articles

[springboot] logback-spring.xml , Slf4jSpyLogDelegator 사용중일 때 설정 방법 예시 by ChatGpt

java springboot환경에서 logback 라이브러리를 이용하여, 백엔드 서버 로그를 파일로 남기고...

관리자Dec 30, 2025

[Android] java.lang.IllegalArgumentException: Unable to create call adapter for interface retrofit2.Call, Caused by: java.lang.IllegalArgumentException: Call return type must be parameterized as Call or Call 오류 해결 방법

오류 내용 : minifyEnabled true로 바꾸자마자 발생하는 전형적인 Retrofit ProGuard/R8...

관리자Dec 19, 2025

[PostgreSQL, JAVA] ARRAY_AGG(ad_cnt) 결과를 Java(Spring Boot, JPA, MyBatis 모두 포함)에서 어떻게 받아서 처리하는지 예제 포함

다음 내용은 ARRAY_AGG(ad_cnt) 결과를 Java(Spring Boot, JPA, MyBatis 모두 포함)에서...

관리자Dec 10, 2025