AgentSkillsCN

spring-exception-handler

设计或修改 Spring Security 设置(SecurityFilterChain、认证/授权、CORS)。在需要应用 API 安全规则与认证流程时使用。

SKILL.md
--- frontmatter
name: spring-exception-handler
description: Spring 전역 예외 처리(@ControllerAdvice)와 에러 응답 포맷을 설계/수정한다. 상태 코드 매핑과 일관된 에러 응답 규약이 필요할 때 사용한다.

작업 절차

  1. 도메인/애플리케이션 예외 목록과 상태 코드 매핑을 정의한다.
  2. 전역 예외 핸들러(@RestControllerAdvice)를 작성한다.
  3. 공통 에러 응답 모델을 정의한다.
  4. 컨트롤러 테스트로 상태 코드/응답 스키마를 검증한다.

모듈 내부 배치 규칙

  • 예외 핸들러와 API 에러 모델은 modules/apiexception 패키지에 둔다.
  • 도메인 예외 타입 자체는 modules/domainexception에 둔다.

번들 리소스

  • 레퍼런스 인덱스: references/INDEX.md
  • 예외 매핑 체크리스트: references/exception-mapping-checklist.md
  • 전역 예외 핸들러 샘플: references/global-exception-handler-sample.md
  • 프로젝트 컨트롤러 테스트 가이드: ../../../agents/guidelines/controller-testing.md
  • 예외 핸들러 스캐폴드 스크립트: scripts/scaffold_exception_handler.py
  • API 에러 응답 템플릿: assets/api_error_response_template.kt