Mac下Laravel11怎么使用Inertia.js-php教程-PHP中文网

inertia::render() 返回空白页或404，主因是laravel 11中handleinertiarequests中间件未注册、路由未显式加middleware('web')、vite下resolve路径不匹配（如大小写/斜杠错误）或app_url配置不当；mac环境本身无影响，问题全在配置链断裂。

mac下laravel11怎么使用inertia.js

Inertia::render() 在 Laravel 11 + Mac 环境下跑不起来，90% 是因为中间件没挂对、前端 resolve 路径错位，或 Vite 配置没适配 Laravel 11 的新结构——不是环境问题，是配置链断了。

为什么 `Inertia::render()` 返回空白页或 404

Mac 系统本身不影响 Inertia 运行，但 Laravel 11 默认启用了新的「stack」路由中间件组和更严格的 Vite 集成方式，旧教程的配置容易失效。

app/Http/Kernel.php 中 $middlewareGroups['web'] 必须包含 \App\Http\Middleware\HandleInertiaRequests::class（Laravel 11 不再默认注册 \Inertia\Middleware::class）
确保路由明确使用 web 中间件：比如 Route::get('/dashboard', [DashboardController::class, 'index'])->middleware('web')；Laravel 11 的 Route::resources() 默认已带，但自定义路由要手动加
resources/js/app.js 里 resolve 函数返回的路径必须严格匹配组件文件位置：Inertia::render('Dashboard') → 对应 resources/js/Pages/Dashboard.vue，大小写、斜杠、扩展名一个都不能错
Mac 上用 npm run dev 启动 Vite 后，检查控制台是否报 Failed to fetch /inertia 或 Cannot find module './Pages/Dashboard.vue' —— 这说明 resolve 路径解析失败，不是服务端问题

`createInertiaApp()` 在 Laravel 11 + Vite 下怎么配

Laravel 11 把 Vite 配置收归 vite.config.js 统一管理，createInertiaApp() 的 resolve 逻辑必须和 laravel-vite-plugin 的 resolvePageComponent() 对齐，否则组件找不到。

Comprehensive Three.js 3D graphics reference

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

下载

安装时用 php artisan inertia:install vue（Laravel 11 自带该命令），它会自动写好 resources/js/app.js 和 vite.config.js 基础结构
resources/js/app.js 中不要手写 require('./Pages/${name}.vue')，改用官方推荐的 resolvePageComponent()：

import { resolvePageComponent } from 'laravel-vite-plugin/inertia-helpers'

createInertiaApp({
  resolve: (name) => resolvePageComponent(`./Pages/${name}.vue`, import.meta.glob('./Pages/**/*.vue')),
  // ...
})

vite.config.js 必须启用 laravel({...} 插件，并确保 input 指向 resources/js/app.js；Mac 上若用 M1/M2 芯片，确认 Node 版本 ≥ 20.9（Vite 5+ 要求）
启动命令必须是 npm run dev（不是 php artisan serve 单独跑），因为 Vite 开发服务器提供 HMR 和模块解析能力，Laravel 内置服务器不处理 .vue 文件

表单提交后数据不更新？别信 `redirect()`

Laravel 11 的验证异常处理更严格，redirect()->route() 会触发完整跳转，彻底退出 Inertia 流程——页面刷新、状态丢失、errors 不注入。

控制器成功处理后，**必须返回 Inertia::render()**，例如创建用户后重定向到列表页：return Inertia::render('Users/Index', ['users' => User::all()])
验证失败时，Laravel 11 默认抛 ValidationException，Inertia 会自动捕获并把 errors 注入 $page.props.errors；Vue 3 中直接用 props.errors.email，不用额外 try/catch
如果想局部更新（比如新增一条后追加进列表），不要 reload 整页，改用 router.reload() 或手动更新 usePage().props.value.users —— 但要注意响应式边界，避免直接 push 到 ref 数组引发丢失
文件上传必须加 enctype="multipart/form-data"，且 useForm() 默认支持，无需封装 FormData；Mac 上 Safari 对 FormData 处理略保守，建议开发期用 Chrome 测试

Mac 下容易被忽略的三个细节

不是 bug，是配置惯性导致的静默失败。

APP_URL 在 .env 里必须设为 http://localhost:8000（不能是 127.0.0.1），否则 Vite 的 HMR 代理和 Inertia 的 XHR 请求可能跨域失败
resources/views/app.blade.php 必须只留一个空 <div id="app"></div> 和 <script src="%7B%7B%20Vite::asset('resources/js/app.js')%20%7D%7D"></script>；Laravel 11 的 Vite::asset() 依赖 vite.config.js 中的 build.outDir 设置，默认是 public/build，别手动生成到错目录
修改 config/inertia.php（运行 php artisan vendor:publish --provider="Inertia\ServiceProvider" 后才有）时，'root_view' 必须是 'app'（对应 resources/views/app.blade.php），不是 'welcome' 或其他，否则中间件找不到根模板，返回空响应