Nuxt3+Laravel9登录后出现502 Bad Gateway问题求助

1. 修复Nuxt3 Nginx配置中的Connection头冲突 #

你的Nuxt配置里重复设置了Connection头，同时指定'upgrade'和"keep-alive"会导致Nginx处理请求时出现混淆，尤其是登录后可能触发WebSocket或长连接请求时。修改配置如下：

server {
    listen 80;
    server_name maindomain.com;
    
    location / {
        proxy_pass http://127.0.0.1:3000;
        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_http_version 1.1;
        # 动态设置Connection头，仅在需要升级时使用upgrade
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
        send_timeout 300s;
    }
}

同时在Nginx的http全局块中添加映射规则：

http {
    # ...其他全局配置
    map $http_upgrade $connection_upgrade {
        default upgrade;
        '' close;
    }
}

该配置会根据请求类型自动适配Connection头，避免冲突。

2. 检查Nuxt3服务稳定性 #

登录后出现502可能是Nuxt服务短暂中断，排查方式：

• 若用PM2管理Nuxt进程，执行pm2 logs nuxt查看是否有崩溃、重启日志
• 直接访问http://127.0.0.1:3000模拟登录流程，验证服务是否会无响应
• 确保Nuxt3以生产模式运行：先执行nuxt build，再启动node .output/server/index.mjs，开发模式不适合线上部署

3. 排查Laravel后端PHP-FPM状态 #

502也可能是PHP-FPM无法处理登录请求，排查步骤：

• 查看PHP-FPM日志（通常在/var/log/php-fpm/目录），检查是否存在进程耗尽、超时或代码错误
• 调整PHP-FPM的www.conf配置，确保pm.max_children、pm.start_servers等参数足够应对并发请求，避免登录高峰时进程不足
• 用Postman直接调用api.maindomain.com/login，验证API本身能否正常返回结果

4. 验证Cookie与Session配置 #

登录后刷新恢复正常，可能和Session/Cookie的域名共享设置有关：

• 在Laravel的.env文件中设置SESSION_DOMAIN=.maindomain.com（前缀的点支持主域名与子域名共享Session）
• 检查Nuxt3的nuxt.config.ts，确保API请求配置正确携带凭证：

export default defineNuxtConfig({
  modules: ['@nuxtjs/axios'],
  axios: {
    baseURL: 'http://api.maindomain.com',
    credentials: true
  }
})

5. 查看Nginx错误日志 #

直接查看Nginx错误日志（通常在/var/log/nginx/error.log），日志会明确记录502错误的具体原因，比如连接Nuxt超时、PHP-FPM无法连接等，这是最直接的排查依据。

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