Laravel+React+Inertia.js修改后页面无更新，求排查解决方法

前端资源构建与缓存排查 #

• 确认前端开发服务正在运行：执行 npm run dev 或 yarn dev（对应Vite/Mix），开发模式下需要持续运行热重载服务才能实时同步组件修改。如果之前没启动或意外终止，修改的React代码不会被编译到前端资源中。
• 清理前端构建缓存：
  • 若使用Vite，删除 node_modules/.vite 目录和 public/build 文件夹，再重新执行 npm run dev。
  • 若使用Laravel Mix，删除 public/js、public/css 下的编译文件，执行 npm run dev 重新构建。
• 强制浏览器硬刷新：使用 Ctrl+Shift+R（Windows）或 Cmd+Shift+R（Mac），彻底绕过浏览器缓存加载资源。

Inertia.js专属问题排查 #

• 清除Inertia客户端状态：打开浏览器开发者工具的「Application」面板，删除sessionStorage和localStorage中以inertia开头的键值对，避免旧页面状态或缓存的组件数据干扰。
• 验证组件注册与路径：
  • 检查routes/web.php中Inertia::render()的组件名称，是否与resources/js/Pages（或自定义组件目录）下的文件路径、导出方式匹配。比如组件用命名导出时，需在渲染时指定：Inertia::render('Pages/MyPage', [], ['component' => 'Pages.MyPage.NamedExport'])。
  • 确认resources/js/inertia.js中的resolveComponent函数配置正确，是否指向了你的组件根目录。
• 禁用页面状态保留：在跳转或链接中添加{ preserveState: false }，比如Inertia.link('/path', { preserveState: false })，避免旧组件状态被保留。

服务端与路由排查 #

• 检查PHP OPcache状态：开发模式下需关闭OPcache，否则PHP文件修改不会生效。执行 php -i | grep opcache 查看opcache.enable的值，若为1，修改php.ini设置opcache.enable=0后重启PHP服务（如FPM、Apache）。
• 确认路由优先级：执行 php artisan route:list 查看实际生效的路由列表，确保修改后的路由没有被旧路由覆盖（Laravel路由按定义顺序匹配，新路由需放在冲突路由之前）。
• 手动清理视图缓存：删除storage/framework/views目录下的所有文件，再重新访问页面，避免残留的编译视图干扰。

其他排查点 #

• 检查反向代理/本地服务缓存：若使用Valet、Homestead或Nginx，确认是否开启了静态资源缓存，暂时关闭缓存配置后测试。
• 验证组件导出：确保React组件使用默认导出（export default MyComponent），或在Inertia渲染时明确指定命名导出，避免组件无法正确加载。

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