故障排除
當生成檔案不存在或 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 계약을 함께 검토하세요.