Khắc phục sự cố

Cấu hình chuẩn hóa . thành / trong nhiều đầu vào path. Có thể trộn lẫn chuỗi package và đường dẫn filesystem, nhưng cần kiểm tra sự khác biệt giữa cấu hình đưa toàn bộ đường dẫn output như src.main.java.com.example... và cấu hình chỉ đưa package 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/

Chạy từ thư mục gốc dự án và kiểm tra routerDir được in ra có chứa mã nguồn router. Nếu routerPackage chứa cả src/main/java, đường dẫn sẽ bị lặp. Truyền cấu hình này vào handlerConfig của runner, rồi chạy với profile local trong Quick Start. handlerPackage là tên package Java; handlerOutputDir là thư mục đầu ra thực tế.

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

Nếu đường dẫn đúng nhưng không có đầu ra, hãy kiểm tra ngoại lệ đầu tiên từ runner.start(). Tái hiện bằng một tuyến tối thiểu có tham chiếu handler::method, kiểm tra tệp sinh ra rồi thêm các tuyến hiện có. Chỉ có swagger.json là chưa đủ: hãy đối chiếu đường dẫn yêu cầu và phương thức HTTP trong paths với hợp đồng phản hồi thực tế.

Swagger writer chỉ ghi tệp khi nội dung thay đổi. Nếu vẫn xảy ra generation lặp lại, hãy kiểm tra xem tệp output có nằm trong watchDirectory hay không, và xem formatter hoặc watcher khác có liên tục thay đổi nguồn đã tạo hay không.