inertia-link 点击无反应，主因是服务端未返回 Inertia 响应：须用 Inertia::render() 而非 view() 或 json()，且需注册 HandleInertiaRequests 中间件，响应头含 X-Inertia: true。

为什么 inertia-link 点击后页面没反应？

多数情况是服务端没正确返回 Inertia 响应，而不是前端配置问题。Laravel 必须用 Inertia::render() 返回页面，直接 return view() 或 return response()->json() 都会断开 Inertia 的接管链。

• 检查控制器方法是否以 Inertia::render('PageName', [...]) 结尾，而非 view()
• 确认中间件 \App\Http\Middleware\HandleInertiaRequests::class 已注册在 app/Http/Kernel.php 的 web 组中
• 浏览器开发者工具 Network 标签页里，点击 inertia-link 发出的请求响应头应包含 X-Inertia: true；若没有，说明服务端未走 Inertia 渲染流程

Laravel 11+ 中 inertia-head 不生效怎么办？

新版 Inertia 默认禁用自动注入 title 和 meta，inertia-head 只负责渲染显式传入的内容，不会自动读取组件内的 usePage().props.title。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

• 在根布局（如 resources/js/Components/Layout.vue）中显式使用：

  <inertia-head :title="page.props.title" />

• 服务端传递 title 时需确保结构一致：Inertia::render('Dashboard')->with('title', '仪表盘')
• 若用 usePage().props.title 动态更新，必须配合 definePage 的 title 选项，否则 inertia-head 无法感知变化

如何让 Laravel 的验证错误在 Inertia 页面中正确显示？

Inertia 默认会把 422 Unprocessable Entity 响应转为页面重载并保留输入值，但表单错误对象（$errors）不会自动挂到 page.props.errors，需要手动桥接。

• 在控制器中，用 with('errors', $validator->errors()) 显式传递：

  Inertia::render('Auth/Login')->withErrors($request->validate([...]))

• 前端 Vue 组件中通过 usePage().props.errors 访问，字段名与表单 key 严格对应（如 email、password）
• 注意：Laravel 10+ 默认启用 Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull，空字符串会被转为 null，可能干扰错误提示逻辑，必要时在表单提交前做预处理

SSR 渲染时 usePage() 报错 “Cannot read property 'props' of undefined”

这是 SSR 上下文里 page 尚未初始化导致的，常见于自定义布局或提前访问 usePage() 的 setup 函数中。

• 避免在 setup() 顶层直接解构 usePage()，改用 onMounted(() => {...}) 或 computed(() => usePage().props.xxx)
• SSR 模式下，usePage() 返回的是一个响应式代理，但初始值为 null，直到客户端 hydration 完成才填充真实数据
• 若必须服务端取值（如 SEO 相关 meta），应在服务端通过 with() 显式传入，而非依赖 usePage() 在 SSR 中读取

Inertia 的“透明感”是双刃剑：它藏起了很多 HTTP 细节，但也让错误更难定位。真正卡住的时候，先看 Network 里响应头有没有 X-Inertia，再查服务端是否真的走了 Inertia::render() —— 这两个点漏掉任何一个，整个链路就断了。