VPS部署遇405错误：域名访问接口失败但IP正常求排查

核心排查逻辑 #

405错误是请求方法不被服务器允许，既然HTTP直连VPS公网IP时功能正常，说明Node后端本身支持GET/POST等方法，问题出在Nginx的HTTPS代理配置环节，以下是具体排查修复步骤：

1. 修正Nginx HTTPS配置的请求方法转发 #

Nginx默认可能未正确传递请求方法到后端，需确保HTTPS server块中接口代理配置包含请求方法转发规则：

server {
    listen 443 ssl;
    server_name 你的主域名;

    ssl_certificate /etc/letsencrypt/live/你的主域名/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/你的主域名/privkey.pem;

    # 前端静态文件代理
    location / {
        root /path/to/你的前端打包目录;
        try_files $uri $uri/ /index.html;
    }

    # 接口代理（假设接口前缀为/api）
    location /api {
        proxy_pass http://localhost:你的Node服务端口;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        # 关键：原样转发请求方法
        proxy_method $request_method;
        proxy_pass_request_method on;
    }
}

重点确认：

• 接口的location路径与前端调用的接口前缀完全匹配
• proxy_method $request_method和proxy_pass_request_method on两行是否存在，确保Nginx不修改请求方法

2. 排查Let's Encrypt自动配置的规则冲突 #

若使用certbot自动生成Nginx配置，可能存在限制请求方法的规则，打开/etc/nginx/sites-available/你的主域名文件，检查是否有类似代码：

location / {
    if ($request_method !~ ^(GET|HEAD)$) {
        return 405;
    }
    try_files $uri $uri/ =404;
}

如果有，需修改为排除接口路径的规则：

location / {
    set $block 0;
    if ($request_method !~ ^(GET|HEAD)$) {
        set $block 1;
    }
    if ($uri ~ ^/api/) {
        set $block 0;
    }
    if ($block = 1) {
        return 405;
    }
    try_files $uri $uri/ /index.html;
}

3. 处理OPTIONS预检请求 #

前端跨域场景下会先发OPTIONS请求，若Nginx未正确处理，会导致后续POST请求被拦截，在HTTPS server块中添加：

# 处理OPTIONS预检请求
if ($request_method = OPTIONS) {
    add_header Access-Control-Allow-Origin https://你的主域名;
    add_header Access-Control-Allow-Methods GET, POST, PUT, DELETE, OPTIONS;
    add_header Access-Control-Allow-Headers Content-Type, Authorization;
    return 204;
}

# 接口代理块中补充跨域头
location /api {
    proxy_pass http://localhost:你的Node服务端口;
    # ... 其他proxy配置 ...
    add_header Access-Control-Allow-Origin https://你的主域名;
    add_header Access-Control-Allow-Methods GET, POST, PUT, DELETE, OPTIONS;
    add_header Access-Control-Allow-Headers Content-Type, Authorization;
}

4. 验证配置并重启Nginx #

修改配置后先检查合法性：

sudo nginx -t

若提示test is successful，重启Nginx：

sudo systemctl restart nginx

用curl测试HTTPS接口：

curl -X POST https://你的主域名/api/register -d "username=test&password=123" -v

查看响应状态码，确认是否解决405问题。

5. 确认Node后端跨域配置 #

确保Node后端的跨域中间件（如cors）允许HTTPS域名：

const cors = require('cors');
app.use(cors({
    origin: 'https://你的主域名',
    methods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS']
}));

内容的提问来源于stack exchange，提问作者BigBigFoot