استكشاف الأخطاء وإصلاحها

يقوم التكوين بتطبيع . إلى / في إدخالات المسار المتعددة. يمكن استخدام سلسلة الحزمة ومسار نظام الملفات بشكل مختلط، ولكن يجب التحقق من الفرق بين الإعداد الذي يضع المسار الكامل مثل src.main.java.com.example... والإعداد الذي يضع فقط حزمة com.example....

import com.byeolnaerim.watch.route.HandlerGenerator;

var handlerConfig = HandlerGenerator.Config.builder()
    .rootPath("src/main/java")
    .routerPackage("com.example.web.router")
    .handlerPackage("com.example.web.handler")
    .handlerOutputDir("src/main/java/com/example/web/handler")
    .build();

System.out.println(handlerConfig.routerDir());
// src/main/java/com/example/web/router/

نفّذ من جذر المشروع وتحقق من أن routerDir المطبوع يحتوي على مصدر الراوتر. تضمين src/main/java في routerPackage يكرر المسار. مرّر هذا الإعداد إلى handlerConfig في runner ثم شغّل باستخدام ملف local من Quick Start. يمثل handlerPackage اسم حزمة Java، ويمثل handlerOutputDir دليل الإخراج الفعلي.

test -d src/main/java/com/example/web/router
find src/main/java/com/example/web/handler -name '*.java'
# Quick Start swaggerOutputFile:
test -s src/main/resources/static/swagger.json

إذا كانت المسارات صحيحة ولم يظهر إخراج، فابدأ بأول استثناء من runner.start(). أعد الإنتاج بمسار واحد بسيط يستخدم مرجع handler::method، وافحص الملفات المولّدة ثم أضف مساراتك الحالية. وجود swagger.json وحده لا يكفي: قارن مسار الطلب وطريقة HTTP في paths بعقد الاستجابة الفعلي.

يكتب كاتب Swagger الملف فقط عند تغيير المحتوى. ومع ذلك، إذا حدثت توليدات متكررة، تحقق مما إذا كان ملف الإخراج مدرجًا في watchDirectory، أو إذا كان المهيئ أو مراقب آخر يغير المصدر الناتج باستمرار.