You need to enable JavaScript to run this app. Next.js部署后直接输入URL访问返回502错误的问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Next.js部署后直接输入URL访问返回502错误的问题求助

核心问题定位

你现在的部署流程把**静态导出(SSG纯静态)和服务端渲染(SSR)**两套完全独立的部署逻辑完全混用了,所有配置错位,直接导致服务异常。
这个问题在本地开发模式下不会出现,是因为本地运行的next dev服务会正常监听路由请求,和服务器上的部署链路完全不一样。

具体错位点

  • 部署产物和启动方式完全不匹配
    你的build脚本配置为next build && next export,执行后生成的out文件夹是纯静态HTML/JS/CSS文件,这类部署不需要Node运行时、不需要启动next start服务、也不需要nginx反向代理到3000端口。
    你当前的操作是:上传了纯静态的out文件夹,同时又用pm2启动next start——但next start是依赖next build生成的.next服务端产物才能正常运行的,你根本没有上传需要的.next目录,pm2启动的Next进程从启动阶段就会报错,3000端口没有正常的服务监听。
    为什么点击导航栏的「about」链接能正常跳转?因为这类跳转是Next.js前端路由在浏览器端的内存级跳转,不会向服务端发起真实HTTP请求,完全不会触发nginx的反向代理逻辑;只要你手动在地址栏输入URL、刷新页面,浏览器就会发起真实请求,nginx把请求转发到没有正常运行的3000端口,自然返回502错误。
  • Nginx配置完全错配
    你当前的nginx配置把所有请求都代理到3000端口,但这个端口上根本没有正常运行的Next服务,同时你已经上传了out静态文件,却没有配置对应的静态文件读取规则,完全没有利用上静态部署的能力。

修正方案(二选一,不能混用)

方案1:保留静态导出(next export)的部署模式

这类模式是更轻量的部署选择,适合纯静态站点:

  • 先停掉pm2里启动的Next进程,删除对应的服务配置:
    pm2 delete next
    
  • 修改nginx的location /块配置,把反向代理规则替换为静态文件服务规则:
    location / {
      # 替换为你服务器上out文件夹的实际存放路径
      root /home/admin/web/example.com/out;
      index index.html;
      # 解决静态站点直接访问深层路由、刷新页面的404/502问题
      try_files $uri $uri.html $uri/ =404;
    }
    
  • 重启nginx即可完成部署,所有请求都会由nginx直接读取静态文件返回,不需要3000端口的服务。

方案2:保留服务端渲染的部署模式(使用next start)

这类模式需要Node服务运行,适合带服务端逻辑、动态SSR页面的站点:

  • 修改package.json的build脚本,删掉静态导出的步骤:
    "build": "next build"
    
  • 本地重新执行build,把生成的.next文件夹、package.json、node_modules依赖包全部上传到服务器,不要上传out文件夹。
  • 重新用pm2启动Next服务,这时候3000端口才会有正常的服务监听,你当前nginx里配置的反向代理规则就能正常生效,不会再出现502错误。

额外排查点

  • 可以用pm2 logs next查看之前启动失败的Next进程日志,基本都会报“找不到.next目录”的启动错误,和上述问题定位完全匹配。
  • 你当前使用的Next.js 10.0.6、Node 12.18.4版本是完全兼容的,不存在版本不匹配导致的502问题。
  • 如果用静态导出方案部署带动态路由的页面,需要在next.config.js中补充对应的静态路由生成规则,避免直接访问动态路径时出现静态文件找不到的问题。

内容的提问来源于stack exchange,提问作者Vasilis Greece

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 14:15:06