自动生成的 Node.js 服务器无法启动 (Swagger/OpenAPI)

Question

我已经通过 Swagger Editor 生成了一个 nodejs-server，但是当我运行“npm start”时，服务器没有启动并且没有返回任何错误。

我第一次运行“npm start”时，所有依赖项都已安装，但“node index.js”没有启动服务器。

我第二次尝试“npm start”:

dev01@dev01:~/nodejs-server$ npm start

> back-end-rota-exata@1.0.0 prestart /home/dev01/nodejs-server
> npm install


> back-end-rota-exata@1.0.0 start /home/dev01/nodejs-server
> node index.js

dev01@dev01:~/nodejs-server$ 

然后我也尝试了“node index.js”:

dev01@dev01:~/nodejs-server$ node index
dev01@dev01:~/nodejs-server$ 

然后什么也没发生...

这是 Swagger Editor 自动生成的“index.js”中的代码:

'use strict';

var fs = require('fs'),
    path = require('path'),
    http = require('http');

var app = require('connect')();
var oas3Tools = require('oas3-tools');
var jsyaml = require('js-yaml');
var serverPort = 8080;

// swaggerRouter configuration
var options = {
  swaggerUi: path.join(__dirname, '/swagger.json'),
  controllers: path.join(__dirname, './controllers'),
  useStubs: process.env.NODE_ENV === 'development' // Conditionally turn on stubs (mock mode)
};

// The Swagger document (require it, build it programmatically, fetch it from a URL, ...)
var spec = fs.readFileSync(path.join(__dirname,'api/swagger.yaml'), 'utf8');
var swaggerDoc = jsyaml.safeLoad(spec);

// Initialize the Swagger middleware
oas3Tools.initializeMiddleware(swaggerDoc, function (middleware) {

  // Interpret Swagger resources and attach metadata to request - must be first in swagger-tools middleware chain
  app.use(middleware.swaggerMetadata());

  // Validate Swagger requests
  app.use(middleware.swaggerValidator());

  // Route validated requests to appropriate controller
  app.use(middleware.swaggerRouter(options));

  // Serve the Swagger documents and Swagger UI
  app.use(middleware.swaggerUi());

  // Start the server
  http.createServer(app).listen(serverPort, function () {
    console.log('Your server is listening on port %d (http://localhost:%d)', serverPort, serverPort);
    console.log('Swagger-ui is available on http://localhost:%d/docs', serverPort);
  });

});

注意:我没有修改任何行。

Answer 1

我遇到了同样的问题，我所做的是将 swagger.yaml 的定义从 openapi: 3.0.0 更改为 openapi: 3.0.1 ，服务器正常工作。