[Node.js] Swagger에 "No operations defined in spec!"만 표시될 때

에러

swagger-jsdoc과 swagger-ui-express를 사용하여 서버의 API를 문서화하려고 하는데, 위와 같이 "No operations defined in spec!" 만 표시되었다.

문제 해결

swagger-jsdoc의 options를 지정해줄 때, apis에 상대경로가 아니라 소스파일이 들어있는 제일 위의 폴더부터 절대경로로 지정하면 된다.

const swaggerDefinition = {
  openapi: "3.0.0",
  info: {
    title: "Twitter",
    version: "1.0.0",
    description: "유석현의 Twitter",
  },
  servers: [
    {
      url: "http://localhost:8000",
    },
  ],
};

const options = {
  swaggerDefinition,
  // 절대경로로 지정
  apis: ["src/**/*.js"],
};