トラブルシューティング
生成ファイルがない場合やroute/typeが欠落している場合、設定とサポートコードの形を順番に確認します。
確認順序
• @Profile("local")が実際の実行プロファイルに含まれているか確認します。
• runner.start()の例外がローカルコンソールで発生していないか確認します。
• rootPath, routerPackage, entityPackage, handlerOutputDirがドット/スラッシュ変換後に正しい位置にあるか確認します。
• 生成されたソースディレクトリがIDEとビルドツールのソースセットに含まれているか確認します。
• 外部共通モジュールタイプは、デコンパイルしたjarクラスまたはソースクラスパスに追加します。
• RouterFunctionがサポートされているフルーエントルート/ネストとハンドラメソッドリファレンス形式であるか確認します。
ドットパスとスラッシュパス
Configは複数のパス入力で.を/に正規化します。パッケージ文字列とファイルシステムパスを混用できますが、src.main.java.com.example...のように全体の出力パスを入れる設定とcom.example...パッケージのみを入れる設定の違いを確認する必要があります。
無限再生成
Swaggerライターは内容が変更されたときのみファイルを書き込みます。それでも繰り返し生成が発生する場合は、出力ファイルがwatchDirectory内に含まれているか、フォーマッタや他のウォッチャーが生成されたソースを継続的に変更しているか確認してください。
静的分析の限界
runtime動的ルートは完全に推論できません
조건문으로 runtime에만 만들어지는 path, reflection 기반 DTO, 복잡한 generic wrapper는 annotation override 또는 custom type mapper가 필요할 수 있습니다. 생성된 JSON과 실제 endpoint 계약을 함께 검토하세요.