故障排除
当生成文件缺失或 route/type 缺失时，依次检查设置和支持代码的形状。
确认顺序
• 检查 @Profile("local") 是否包含在实际执行的配置文件中。
• 确保 runner.start() 在本地控制台中没有抛出异常。
• 检查 rootPath、routerPackage、entityPackage、handlerOutputDir 在点/斜杠转换后是否位于正确的位置。
• 确保生成的源目录包含在 IDE 和构建工具的源集内。
• 将外部公共模块类型添加到反编译的 jar 类或源类路径中。
• 确保 RouterFunction 支持流式路由/嵌套和处理方法引用的形式。
点路径与斜杠路径
配置在多个路径输入中将 . 规范化为 /。可以混合使用包字符串和文件系统路径，但需要确认将完整输出路径如 src.main.java.com.example... 与仅输入 com.example... 包的设置之间的差异。
无限重生
Swagger 写入器仅在内容更改时写入文件。即使如此，如果发生重复生成，请检查输出文件是否包含在 watchDirectory 中，格式化程序或其他监视器是否持续更改生成的源。
静态分析限制
运行时动态路由无法完全推断。
조건문으로 runtime에만 만들어지는 path, reflection 기반 DTO, 복잡한 generic wrapper는 annotation override 또는 custom type mapper가 필요할 수 있습니다. 생성된 JSON과 실제 endpoint 계약을 함께 검토하세요.