backend: MCP annotation scanner BeanPostProcessorChecker WARN 정리

[aeei]

배경

p11 deskpie clean boot에서 Spring AI MCP annotation scanner 기동 중 아래 BeanPostProcessorChecker WARN 4건이 발생한다.

수집 명령:

scripts/dev restart -p 11 -s deskpie -v

수집 로그:

Apr 28 03:57:46.424 |WARN| Bean 'org.springframework.ai.mcp.server.common.autoconfigure.annotations.McpServerAnnotationScannerAutoConfiguration' ... is not eligible for getting processed by all BeanPostProcessors ... currently created BeanPostProcessor [serverAnnotatedMethodBeanPostProcessor] ... declare it with ROLE_INFRASTRUCTURE.
Apr 28 03:57:46.432 |WARN| Bean 'serverAnnotatedBeanRegistry' ... is not eligible for getting processed by all BeanPostProcessors ... currently created BeanPostProcessor [serverAnnotatedMethodBeanPostProcessor] ...
Apr 28 03:57:46.451 |WARN| Bean 'stringOrNumberMigrationVersionConverter' ... is not eligible for getting processed by all BeanPostProcessors ... currently created BeanPostProcessor [serverAnnotatedMethodBeanPostProcessor] ...
Apr 28 03:57:46.457 |WARN| Bean 'spring.ai.mcp.server.annotation-scanner-org.springframework.ai.mcp.server.common.autoconfigure.annotations.McpServerAnnotationScannerProperties' ... is not eligible for getting processed by all BeanPostProcessors ... currently created BeanPostProcessor [serverAnnotatedMethodBeanPostProcessor] ...

현재 의존성:

• org.springframework.ai:spring-ai-starter-mcp-server-webmvc:2.0.0-M4
• org.springframework.ai:spring-ai-mcp-annotations:2.0.0-M4

현재 설정:

• backend/app/src/main/resources/application.yaml
  • spring.ai.mcp.server.annotation-scanner.enabled: true
• backend/app/src/main/resources/application-local.yaml
  • logging.level.org.springframework.context.support.PostProcessorRegistrationDelegate$BeanPostProcessorChecker: ERROR가 있으나, 실제 /actuator/loggers/org.springframework.context.support.PostProcessorRegistrationDelegate$BeanPostProcessorChecker effectiveLevel은 INFO로 관측됨.

리서치 메모

• Spring Framework 문서상 이 WARN은 BeanPostProcessor와 그 직접 참조 bean들이 early startup phase에서 생성되어 전체 post-processing/autoproxy 대상이 되지 않을 때 발생한다. 즉 단순 미관 로그가 아니라 auto-proxy 누락 가능성을 알리는 신호일 수 있다.
  • https://docs.spring.io/spring-framework/reference/7.0-SNAPSHOT/core/beans/factory-extension.html
• Spring AI MCP annotation scanner auto-configuration은 spring.ai.mcp.server.annotation-scanner.enabled=true이며 matchIfMissing=true라, annotation scanner dependency가 있으면 기본 활성화된다.
  • https://docs.spring.io/spring-ai/docs/current/api/org/springframework/ai/mcp/server/common/autoconfigure/annotations/McpServerAnnotationScannerAutoConfiguration.html
• Spring AI 공식 문서는 annotation scanner가 MCP annotated beans를 자동 탐지/등록한다고 설명한다.
  • https://docs.spring.io/spring-ai/reference/api/mcp/mcp-annotations-server.html
• 동일한 WARN 묶음이 Spring AI upstream issue로 보고되어 있다.
  • Undesired and confusing logging spring-projects/spring-ai#4694
• 기존 spring-ai-community/mcp-annotations repo는 Spring AI 2.x+로 이동했고 더 이상 active maintain 대상이 아니라고 안내한다.
  • https://github.com/spring-ai-community/mcp-annotations

목표

MCP 기능을 깨지 않으면서 boot log의 BeanPostProcessorChecker WARN 4건을 제거하거나, upstream 제약으로 당장 제거가 불가능하면 안전한 suppress 범위와 근거를 명확히 남긴다.

태스크

• deskpie, linkpie, app별로 @McpTool, @McpResource, @McpPrompt, @McpComplete 사용 범위를 정리한다.
  • deskpie에서 실제 필요한 MCP annotation scanner 범위를 확인한다.
  • scanner를 서비스별로 조건부 활성화할 수 있는지 확인한다.
• upstream 상태 확인
  • spring-projects/spring-ai#4694 상태/패치 여부 확인.
  • 현재 사용 중인 2.0.0-M4 이후 릴리스/스냅샷에서 해결됐는지 dependency bump 실험으로 확인.
  • milestone/RC/alpha는 프로젝트 정책상 바로 채택하지 말고, 안정 릴리스 후보만 최종안으로 제안한다.
• local 재현 테스트/검증 루틴 작성
  • 최소 :dist:deskpie:bootRun 또는 scripts/dev restart -p 11 -s deskpie -v 로그에서 해당 WARN 4건을 grep으로 검출하는 재현 절차를 문서화한다.
  • 수정 후 같은 절차에서 WARN이 사라졌는지 확인한다.
• 해결안 A: Spring AI 버전 업데이트 검증
  • Spring AI BOM/관련 MCP artifact 업데이트로 WARN이 사라지는지 확인한다.
  • MCP tool/resource 등록과 /mcp smoke test가 계속 통과하는지 확인한다.
• 해결안 B: annotation scanner 비활성 + 명시적 provider 등록 검토
  • spring.ai.mcp.server.annotation-scanner.enabled=false로 WARN이 사라지는지 확인한다.
  • 필요한 MCP tools/resources를 명시적 provider bean으로 등록 가능한지 확인한다.
  • reflection/annotation scanner 의존도를 낮출 수 있으면 이 방향을 우선 검토한다.
• 해결안 C: 로그 레벨 suppress는 최후 수단으로만 검토
  • 현재 application-local.yaml의 logger 설정이 effectiveLevel INFO로 남는 이유를 확인한다.
  • 정확한 logger key 또는 logback 설정으로 4건만 suppress 가능한지 확인한다.
  • 단, suppress 전에는 early bean 생성이 실제 AOP/transaction/security proxy 누락을 만들지 않는다는 근거를 남긴다.
• 회귀 검증
  • MCP endpoint smoke test: /mcp 초기화/도구 또는 리소스 목록 조회.
  • backend 관련 테스트: MCP integration test 또는 대상 모듈 테스트.
  • boot log grep: BeanPostProcessorChecker WARN 0건.

완료 조건

• scripts/dev restart -p 11 -s deskpie -v 기준 해당 4개 WARN이 사라지거나, upstream bug로 보류 시 suppress/보류 근거가 문서화되어야 한다.
• MCP 기능 smoke test가 통과해야 한다.
• PR에는 선택한 해결안과 버린 해결안을 함께 기록한다.

[keIIy-kim]

추가 리서치 (2026-04-28)

현재 p11 deskpie clean boot에서 재현되는 4건은 upstream에 보고된 Spring AI MCP annotation scanner 로그와 동일 계열로 보입니다.

관측

재현 명령:

scripts/dev restart -p 11 -s deskpie -v

현재 남는 항목:

• McpServerAnnotationScannerAutoConfiguration
• serverAnnotatedBeanRegistry
• stringOrNumberMigrationVersionConverter
• McpServerAnnotationScannerProperties

모두 serverAnnotatedMethodBeanPostProcessor 생성 중 early bean creation으로 BeanPostProcessorChecker에 걸립니다.

로컬 구조

• 전역 설정: backend/app/src/main/resources/application.yaml
  • spring.ai.mcp.server.annotation-scanner.enabled: true
• runtime dependency:
  • spring-ai-starter-mcp-server-webmvc
  • spring-ai = 2.0.0-M4
  • mcp-sdk = 1.1.1
• annotation 사용 범위:
  • 공통 backend/mcp: McpUiProbeTool, McpUiProbeResource
  • linkpie: ManageCalendarMcpTool, ManageContactMcpTool, ContactSearchPageMcpTool, ContactGetDetailMcpTool, CalendarWidgetResource, ContactsWidgetResource
  • deskpie: 직접 MCP tool/resource는 없지만 dist가 :mcp를 포함해서 probe tool/resource 때문에 scanner가 활성화됩니다.

upstream/문서 근거

• Spring Framework BeanPostProcessorChecker는 BeanPostProcessor 생성 중 만들어진 bean이 전체 BeanPostProcessor 적용 대상이 아닐 때 로그를 냅니다.
  • https://docs.spring.io/spring-framework/docs/5.0.12.RELEASE_to_5.0.13.RELEASE/Spring%20Framework%205.0.13.RELEASE/org/springframework/context/support/PostProcessorRegistrationDelegate.BeanPostProcessorChecker.html
• Spring AI MCP annotation scanner auto configuration은 spring.ai.mcp.server.annotation-scanner.enabled=true이고 matchIfMissing=true라 annotation scanner classpath가 있으면 기본 활성입니다.
  • https://docs.spring.io/spring-ai/docs/current/api/org/springframework/ai/mcp/server/common/autoconfigure/annotations/McpServerAnnotationScannerAutoConfiguration.html
• Spring AI MCP annotations 문서는 annotation-based tool/resource/prompt/completion 등록을 공식 경로로 설명합니다.
  • https://docs.spring.io/spring-ai/reference/api/mcp/mcp-annotations-server.html
• 동일한 WARN 묶음이 upstream Spring AI issue로 열려 있고 아직 open / waiting-for-triage 상태입니다.
  • Undesired and confusing logging spring-projects/spring-ai#4694
• Maven Central 기준 현재 spring-ai-starter-mcp-server-webmvc 2.x 라인은 2.0.0-M4가 관측됩니다.
  • https://repo1.maven.org/maven2/org/springframework/ai/spring-ai-starter-mcp-server-webmvc/

현재 판단

단순 app 코드 버그라기보다 Spring AI MCP annotation scanner의 BeanPostProcessor 등록 방식/생성 시점 문제일 가능성이 높습니다. 다만 우리 쪽에서 선택 가능한 해결 방향은 있습니다.

1. 서비스별 scanner 활성 조건 분리
   • deskpie는 현재 :mcp probe 때문에 scanner가 켜집니다.
   • deskpie에서 MCP probe가 필수인지 먼저 결정해야 합니다.
2. annotation scanner 비활성 + 명시적 provider 등록
   • spring.ai.mcp.server.annotation-scanner.enabled=false로 WARN 제거 가능성을 확인.
   • 필요한 tool/resource를 ToolCallbackProvider/resource provider 등 명시 등록으로 대체 가능한지 검증.
   • annotation reflection 의존을 줄일 수 있어 장기적으로 가장 깔끔한 방향 후보입니다.
3. 로그 suppress는 최후 수단
   • upstream 제약 때문에 보류해야 할 때만 고려.
   • suppress 전 MCP tool/resource 등록 smoke test와 proxy 누락 영향 없음 근거가 필요합니다.

다음 실험 제안

• deskpie에서 spring.ai.mcp.server.annotation-scanner.enabled=false로 부팅해 WARN 0건이 되는지 확인.
• 동시에 /mcp initialize/tools/resources smoke test로 기능 손상 여부 확인.
• 기능이 깨지면 공통 :mcp probe를 service/profile 조건부로 분리하거나 명시 provider 등록 전환을 검토.

[aeei]

구현/검증 업데이트

• 원인: Spring AI MCP annotation scanner가 serverAnnotatedMethodBeanPostProcessor 생성 중 scanner 관련 bean을 조기 생성해서 BeanPostProcessorChecker WARN 4건을 발생시켰습니다.
• 수정: 기본값을 spring.ai.mcp.server.annotation-scanner.enabled=false로 전환하고, scanner 없이 SyncMcpAnnotationProviders로 MCP tool/resource SyncToolSpecification / SyncResourceSpecification을 명시 등록했습니다. env SPRING_AI_MCP_SERVER_ANNOTATION_SCANNER_ENABLED=true로 기존 scanner 경로 재활성화도 가능합니다.
• 회귀 테스트: ./gradlew :mcp:test --tests 'io.deck.mcp.config.SpringMcpProbeAnnotationContractTest' :linkpie:test --tests 'io.deck.linkpie.mcp.SpringMcpAnnotationContractTest' ✅\n- 부팅 검증: scripts/dev restart -p 11 -s deskpie -v ✅\n - latest boot BeanPostProcessorChecker count: 0\n - latest boot WARN/ERROR: Flyway outOfOrder WARN 1건만 확인(의도된 설정)\n - MCP registration 유지: Registered tools: 1, Registered resources: 1\n- 커밋: d5253249c fix: register mcp specs without annotation scanner