Troubleshooting
생성 파일이 없거나 route/type이 누락될 때 설정과 지원 코드 모양을 순서대로 확인합니다.
확인 순서
• @Profile("local")이 실제 실행 profile에 포함되어 있는지 확인합니다.
• runner.start() 예외가 local console에서 발생하지 않았는지 확인합니다.
• rootPath, routerPackage, entityPackage, handlerOutputDir가 dot/slash 변환 후 올바른 위치인지 확인합니다.
• 생성 source directory가 IDE와 build tool source set에 포함되어 있는지 확인합니다.
• 외부 공통 모듈 type은 decompile jar class 또는 source classpath에 추가합니다.
• RouterFunction이 지원되는 fluent route/nest와 handler method reference 형태인지 확인합니다.
dot path와 slash path
Config는 여러 path 입력에서 .을 /로 정규화합니다. package 문자열과 filesystem path를 혼용할 수 있지만, src.main.java.com.example...처럼 전체 output path를 넣는 설정과 com.example... package만 넣는 설정의 차이를 확인해야 합니다.
무한 재생성
Swagger writer는 내용이 바뀔 때만 파일을 씁니다. 그럼에도 반복 generation이 발생하면 output 파일이 watchDirectory 안에 포함됐는지, formatter나 다른 watcher가 generated source를 계속 바꾸는지 확인하세요.