Inertia.js Laravel 适配器中修改渲染端口的正确方法

在基于Inertia.js和Laravel构建的应用中，服务器端渲染(SSR)是一个提升首屏加载性能的重要特性。本文将详细介绍如何正确修改渲染服务的监听端口，避免常见的配置陷阱。

问题背景

Inertia.js Laravel适配器默认使用13714端口运行渲染服务。当开发者需要修改这个端口时，仅仅修改渲染配置文件中的端口设置是不够的，这会导致渲染内容无法正确显示。

完整配置步骤

1. 修改渲染服务端口 在项目的渲染配置文件中，找到createServer调用部分，将默认的13714端口修改为你需要的端口号，例如13715。

2. 更新Laravel配置 必须同步修改Laravel项目中config/inertia.php配置文件中的渲染端口设置，使其与渲染配置文件中的端口保持一致。

3. 重启渲染服务 修改完成后，需要停止并重新启动渲染服务才能使更改生效：

   php artisan inertia:stop-render
   php artisan inertia:start-render
   

原理分析

Inertia.js的渲染工作流程包含两个关键部分：

• Node.js服务：负责实际渲染Vue组件
• PHP客户端：向Node服务发起请求获取渲染结果

当这两个部分的端口配置不一致时，PHP客户端无法正确连接到Node服务，导致渲染功能失效但不会抛出明显错误。

最佳实践建议

1. 将渲染端口配置提取到环境变量中，确保前后端使用同一值
2. 修改端口后，建议清除应用缓存
3. 在生产环境中，建议通过Nginx等反向代理管理端口

通过遵循以上步骤和原则，开发者可以安全地修改Inertia.js渲染服务的监听端口，同时保持应用的渲染功能正常工作。