swagger $ref,无法解析引用:尝试解析相对 URL,但没有基本路径。路径:'user.yaml' 基本路径:'未定义'

ele*_*sis 11 swagger swagger-ui

我多次更改 $ref 值,
但所有这些都显示相同的错误...请帮助我,请问出了
什么问题?

swagger-ui 错误消息
我的目录图像

swagger.js

import swaggereJsdoc from 'swagger-jsdoc';

const options = {
  swaggerDefinition: {
    info: {
      title: 'User API',
      version: '1.0.0',
      description: 'User API with express',
    },
    host: 'localhost:8000',
    // basePath: '/api',
  },
  apis: ['./routers/*.js', './swagger/*'],
};

export const specs = swaggereJsdoc(options);

Run Code Online (Sandbox Code Playgroud)

用户路由器.js

/**
 * @swagger
 *  /api/users:
 *    get:
 *      tags:
 *      - user
 *      description: users (array)
 *      produces:
 *      - application/json
 *      responses:
 *       '200':
 *          description: success getUsers
 *
 *          schema:
 *            $ref: './swagger/user.yaml#/components/schemas/User'
 */
Run Code Online (Sandbox Code Playgroud)

用户.yaml

# /swagger/user.yml

components:
  schemas:
    User:
      properties:
        id:
          type: integer
          description: primary key
Run Code Online (Sandbox Code Playgroud)

在这个问题之前测试代码:

$ref: './swagger/user.yaml#/components/schemas/User'
$ref: '/swagger/user.yaml#/components/schemas/User'
$ref: 'swagger/user.yaml#/components/schemas/User'
$ref: './user.yaml#/components/schemas/User'
$ref: '/user.yaml#/components/schemas/User'
$ref: 'user.yaml#/components/schemas/User'
Run Code Online (Sandbox Code Playgroud)