Docker容器化Next.js+Nginx部署故障排查求助

以下是可能导致/_next/路径报错、页面空白的核心原因及检查方向：

• Nginx代理配置未覆盖/_next/路径
  Next.js的/_next/路径对应编译后的静态资源包，若Nginx的default.conf中仅配置了根路径/的代理，未单独处理/_next/请求，或者配置错误（比如误将该路径指向Nginx本地目录），会直接导致静态资源404。需确保这类请求完整转发到Next.js服务，示例配置：

  server {
      listen 80;
      server_name localhost;
  
      # 转发Next.js静态资源请求
      location /_next/ {
          proxy_pass http://nextjs:3000;
          proxy_set_header Host $host;
          proxy_set_header X-Forwarded-For $remote_addr;
          proxy_set_header X-Forwarded-Proto $scheme;
      }
  
      # 转发所有其他请求到Next.js
      location / {
          proxy_pass http://nextjs:3000;
          proxy_set_header Host $host;
          proxy_set_header X-Forwarded-For $remote_addr;
          proxy_set_header X-Forwarded-Proto $scheme;
      }
  }
  

  注意：使用docker-compose时，上游地址http://nextjs:3000对应服务名称，无需用localhost；若用host网络，需确保Next.js监听0.0.0.0而非仅127.0.0.1。

• Next.js路径前缀配置不匹配
  若项目中设置了basePath或assetPrefix（比如basePath: '/my-app'），但Nginx未对应调整代理规则，会导致静态资源路径拼接错误。此时需在Nginx配置中添加前缀匹配，或者确保Next.js的前缀与Nginx转发路径一致。

• Next.js构建产物缺失关键目录
  采用experimental.outputStandalone模式时，构建会生成standalone目录，但必须同时复制.next/static目录到容器中——该目录存放了所有静态资源文件，遗漏会导致/_next/static/路径下的资源全部丢失。常规模式下也要确认.next目录完整复制到容器内，Dockerfile示例：

  # 常规模式
  COPY --from=builder /app/.next ./.next
  # Standalone模式
  COPY --from=builder /app/standalone ./
  COPY --from=builder /app/.next/static ./.next/static
  

• Next.js服务监听地址错误
  即使使用host网络模式，若Next.js服务仅监听127.0.0.1:3000，其他容器（或宿主机）无法访问。需确保启动命令绑定0.0.0.0，比如next start -p 3000 -H 0.0.0.0（默认next start已监听0.0.0.0，但若有自定义启动脚本需检查）。

• Nginx静态资源权限问题
  若尝试让Nginx直接托管Next.js静态资源（挂载.next目录到Nginx容器），需确保Nginx进程拥有读取该目录的权限。可在Nginx Dockerfile中添加RUN chown -R nginx:nginx /usr/share/nginx/html（对应挂载路径），避免因权限不足返回403错误。

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