Laravel+Next.js SSR项目外链访问始终返回首页如何解决

手动注入__NEXT_DATA__无法解决路由跳转首页的问题，本质是两个认知错误：

• nextExport: true、autoExport: true是Next.js静态导出（next export）场景的专属标记，SSR模式下Next.js不会读取这两个配置，路由匹配完全以服务端收到的实际请求路径为准
• 你当前的请求链路存在路径透传失败问题：所有用户请求到Laravel后，都被直接返回了Next.js的首页静态文件，原始访问路径根本没有传递给Next.js的路由匹配逻辑，不管注入什么__NEXT_DATA__，Next.js初始化时拿到的请求上下文都是根路径/，自然只会渲染首页。

根据你实际采用的Next.js部署模式二选一即可：

方案1：采用标准SSR模式部署（Next.js跑独立Node服务） #

不要让Laravel直接返回静态首页文件，将所有前端路由请求反向代理到本地启动的Next.js服务（默认端口3000），透传完整请求信息：

• 如果用Nginx做代理，核心配置如下，禁止把请求URI统一重写到/index.html：

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-Request-URI $request_uri;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

• 如果是在Laravel控制器内做请求转发，需要把当前请求的路径、查询参数、请求头完整转发给Next.js SSR服务，拉取对应路径的渲染结果后再返回给客户端，禁止所有路由都返回同一份首页HTML。

方案2：采用静态导出模式部署（无Node服务，静态文件由Laravel托管） #

如果不需要SSR实时渲染能力，直接用next export导出全量静态文件，修正__NEXT_DATA__注入逻辑：

• 动态路由的page字段必须和Next.js的页面文件路径完全匹配，比如访问/post/123对应pages/post/[id].js时，page值必须为/post/[id]，不能直接填/post/123，同时query字段要携带{ "id": "123" }的路由参数
• 先排查Laravel兜底路由的逻辑，确保$request->path()能拿到用户访问的真实路径，不会因为中间件、路由优先级问题把所有路径都解析为/
• Next.js配置里的trailingSlash规则要和Laravel的路由规则完全一致，避免末尾斜杠差异导致客户端路由校验失败回退到首页。

额外排查点：打开浏览器开发者工具的网络面板，查看外链访问时返回的HTML内容里__NEXT_DATA__的page字段是否和访问路径匹配，如果返回的HTML里page值始终是/，说明Laravel侧的请求路径获取逻辑本身就有问题，和Next.js无关。

内容的提问来源于stack exchange，提问作者Patrick Deitós Cremonese