inertia::render() 返回空白页或404最常见原因是未注册inertia中间件或路由未使用web组；需在kernel.php的web组添加\inertia\middleware::class，确保路由用web中间件，并在app.js中正确调用createinertiaapp()且路径严格匹配组件名。
Inertia.js 对接 Laravel 不需要写 API，核心是让 Laravel 控制器返回组件名和数据，前端自动加载并渲染对应 Vue/React 页面——只要中间件、入口挂载、路径映射三者对得上，就能跑起来。
为什么 Inertia::render() 返回空白页或 404
最常见原因是中间件没注册或路由没走 web 组。Laravel 默认不会处理 Inertia 响应，必须显式启用。
-
app/Http/Kernel.php的$middlewareGroups['web']中要包含\Inertia\Middleware::class - 确保路由用了
web中间件（比如Route::middleware('web')或资源路由默认已带） -
resources/js/app.js中resolve函数返回的路径必须严格匹配控制器传入的组件名：比如Inertia::render('Dashboard')要求存在resources/js/Pages/Dashboard.vue - Vue 3 项目里不能用
new Vue()，必须用createApp()+h(App, props)挂载，否则控制台可能静默失败
Inertia::render() 的参数怎么传才安全
第二个参数是数组，直接传 PHP 变量，但要注意序列化边界和敏感字段过滤。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 对象需转为数组或使用
toArray()，避免 Eloquent 模型直接进 props（会带大量未序列化属性） - 关系数据要显式加载：
User::with('posts')->get()，否则前端访问user.posts会报错 - 密码哈希、API token、session ID 等绝不能放进 props——Inertia 数据走 HTTP 明文传输，无加密
- 大数据集（如上万条记录）别直接
all()传，用分页或懒加载替代，否则首屏卡死
表单提交后页面不刷新，但数据没更新
这是典型的状态不同步：后端改了数据库，但前端 props 还是旧的，因为 Inertia 不自动重拉页面数据。
- 成功提交后，控制器必须返回
Inertia::render()（比如跳转回列表页），而不是redirect()->route() - 如果想局部刷新（比如新增一条后追加到列表），可用
router.reload()或手动更新usePage().props.value - 验证失败时 Laravel 抛
ValidationException，Inertia 会自动注入errors对象，Vue 里直接用form.errors.name就行 - 文件上传要加
enctype="multipart/form-data"，且useForm()默认支持，不用额外配 FormData
前端怎么访问服务端传来的数据
不是通过 axios.get() 请求，而是靠 $page.props 注入，本质是服务端拼好再一次性下发。
- Vue 3 中用
defineProps({ users: Array })显式声明，类型不对会警告 - 全局数据（如用户信息）通常放在
app.blade.php的@inertia指令中，由中间件注入，无需每个页面重复传 - 不要在
onMounted里再发请求拉一遍相同数据——props 已是最新的，重复请求纯属浪费 -
usePage().props.auth.user这类路径访问要确认中间件是否已把auth加进共享数据（HandleInertiaRequests中配置）
最容易被忽略的是中间件注册和组件路径大小写——Linux 服务器上 Users/Index.vue 和 users/index.vue 是两个文件，而 Inertia::render('users/index') 在本地开发可能不报错，部署后直接 404。
