Swagger 文档不适用于 Express 服务器

Question

所以基本上我有一个 Express API 我一直在努力，最近我有了为它实现文档的想法。我选择 Swagger 和 JSDoc 来执行此操作，因为它既快速又简单。但是文档不起作用。这是我到目前为止的实现方式。

docs.ts:

import swaggerJSDoc, { Options } from "swagger-jsdoc";

const swaggerOptions: Options = {
   definition: {
      info: {
         title: "Project Nonya Documentation.",
         description: "Documentation for the Project Nonya API",
         contact: {
            name: "Joe Mama",
         },
         version: "6.9.0",
      },
   },
   apis: ["./routes/*.routes.ts"],
};

export const swaggerDocs = swaggerJSDoc(swaggerOptions);

router.ts:

...

import swaggerUi from "swagger-ui-express";
import { swaggerDocs } from "./docs";

...

app.use("/api/documentation", swaggerUi.serve, swaggerUi.setup(swaggerDocs));

...

当我到达 docs 端点时，文档确实出现了，但它一直显示 No Operations defined in spec!。这是 routes 文件夹中的文件之一。

testing.routes.ts:

import express, { Router } from "express";
import { testing} from "../controllers/testing/testing.controller";

const router: Router = express.Router();

/**
 * @swagger
 * /:
 *   get:
 *     description: Why you no work?
 *     responses:
 *       200:
 *         description: Returns nothing cause this shit won't work.
 */
router.post("/testing/:id", testing);

export default router;

我做错了什么？我想不通。目录如下：src/docs.ts、src/router.ts 和 src/routes/testing.router.ts.

附带问题

由于我使用的是TypeScript，显然我必须将代码编译成JavaScript。然而，在 docs.ts 的 apis 数组中，我用 *.routes.ts 指定了文件。我是否必须将其更改为 *routes.js.

谢谢！

Answer 1

发现这个 Github 问题可以解决我的问题。

https://github.com/Surnet/swagger-jsdoc/issues/150

Swagger 文档不适用于 Express 服务器

Swagger documentation not working for Express server

javascript

jsdoc

express

swagger

typescript