Strapi+Nginx部署POST请求500错误求助：POST未送达Strapi

1. 检查Nginx反向代理的POST转发配置 #

POST请求无法到达Strapi，大概率是Nginx的代理配置遗漏了关键项。确保你的Nginx server块包含以下配置：

server {
    listen 80;
    server_name your-domain.com;

    # 调整允许的请求体大小，避免大请求被截断
    client_max_body_size 50M;

    location / {
        proxy_pass http://localhost:1337; # 替换为你的Strapi运行端口
        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_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        # 强制开启请求体和请求头转发
        proxy_pass_request_body on;
        proxy_pass_request_headers on;
    }
}

配置完成后重启Nginx：sudo systemctl restart nginx

2. 验证Nginx是否接收并传递请求体 #

临时开启Nginx的请求体日志（调试完成后关闭），确认请求体是否被正确接收：

log_format post_debug '$remote_addr [$time_local] "$request" '
                      '$status "$request_body"';
access_log /var/log/nginx/strapi_post_debug.log post_debug;

发送POST请求后查看日志，若$request_body为空，说明客户端请求本身有问题，或Nginx的client_max_body_size设置过小。

3. 检查Strapi的CORS配置 #

浏览器端POST请求会先发OPTIONS预检请求，若Strapi未正确响应，实际POST请求不会发送到服务端。修改config/middlewares.js的CORS配置：

module.exports = [
  'strapi::errors',
  {
    name: 'strapi::cors',
    config: {
      origin: ['https://your-frontend-domain.com'], // 替换为你的前端域名
      methods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS'],
      credentials: true,
    },
  },
  'strapi::security',
  'strapi::poweredBy',
  'strapi::logger',
  'strapi::query',
  'strapi::body',
  'strapi::session',
  'strapi::favicon',
  'strapi::public',
];

重启Strapi生效。

4. 绕开Nginx直接测试Strapi #

用curl直接向Strapi端口发送POST请求，验证Strapi本身是否能处理POST：

curl -X POST http://localhost:1337/api/auth/local \
  -H "Content-Type: application/json" \
  -d '{"identifier":"your-email","password":"your-password"}'

如果请求成功，说明问题完全在Nginx配置；如果失败，查看Strapi的./logs/error.log，里面会有具体的错误信息（比如数据库连接失败、权限配置错误）。

5. 检查服务器安全策略 #

如果是Linux服务器，SELinux或防火墙可能阻止Nginx向Strapi端口转发请求：

• 临时关闭SELinux测试：sudo setenforce 0，若问题解决，执行sudo setsebool -P httpd_can_network_connect 1永久允许Nginx网络连接
• 确保防火墙开放Strapi端口：sudo ufw allow 1337

内容的提问来源于stack exchange，提问作者Matteo M.