Node.js Express服务器OPTIONS方法不允许问题求助

问题分析 #

浏览器发送POST请求前会触发OPTIONS预检请求，curl直接发送POST不会触发该流程所以能正常运行。当前代码中自定义的OPTIONS处理被oas3-tools的路由中间件覆盖，导致预检请求返回405错误。

解决方案 #

1. 移除自定义OPTIONS处理，依赖cors中间件自动处理 #

cors()中间件已内置OPTIONS预检请求的处理逻辑，手动定义app.options('*', ...)会和它冲突，直接删除这段代码即可。

2. 配置cors中间件明确允许的规则 #

给cors()添加具体配置，确保预检请求能获取到正确的响应头：

修改后的完整代码：

'use strict';

var path = require('path');
var http = require('http');
var oas3Tools = require('oas3-tools');
var cors = require('cors');
var serverPort = 8080;

// swaggerRouter configuration
var options = {
    routing: {
        controllers: path.join(__dirname, './controllers'),
        exposeApi: true
    },
};

var expressAppConfig = oas3Tools.expressAppConfig(path.join(__dirname, 'api/openapi.yaml'), options);
var app = expressAppConfig.getApp();

// 配置CORS，指定允许的前端域名、请求方法和请求头
app.use(cors({
    origin: 'http://localhost:8081', // 替换为你的Vue前端实际域名/端口
    methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
    allowedHeaders: ['Content-Type', 'Authorization']
}));

// Initialize the Swagger middleware
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);
});

3. 检查OpenAPI规范配置（可选） #

如果你的openapi.yaml中没有为目标接口声明OPTIONS方法，oas3-tools的路由系统可能会拒绝该请求。可以在对应POST接口的paths节点下添加OPTIONS方法声明，或者保持cors()中间件在Swagger路由之前加载，让它优先处理预检请求。

关键注意事项 #

• 中间件顺序不可乱：cors()必须在Swagger路由中间件之前加载，才能优先拦截并处理OPTIONS预检请求。
• 避免重复处理：自定义OPTIONS逻辑和cors中间件的内置处理会冲突，只保留其一即可。

内容的提问来源于stack exchange，提问作者Daniel Hüpenbecker