Laravel 资源路由默认将模型名（如 gallery）作为 URL 中的参数占位符，例如 /admin/gallery/{gallery}/edit；若需显示为 {id}，可通过 ->parameters() 方法自定义参数名，同时保持控制器方法签名一致。
laravel 资源路由默认将模型名（如 `gallery`）作为 url 中的参数占位符，例如 `/admin/gallery/{gallery}/edit`；若需显示为 `{id}`，可通过 `->parameters()` 方法自定义参数名，同时保持控制器方法签名一致。
在 Laravel 中使用 Route::resource() 时，其 URL 结构严格遵循 RESTful 规范。以 Route::resource('/admin/gallery', GalleryController::class) 为例，edit 动作对应的标准路由是：
GET /admin/gallery/{gallery}/edit
⚠️ 注意：不是 /admin/gallery/edit/{id} —— 这是常见误解。资源路由将动词（如 edit、show）置于参数之后，ID（或模型绑定键）必须位于动词前的路径段中。
✅ 正确配置方式
方式一：使用默认参数名 gallery（推荐）
web.php：
Route::resource('/admin/gallery', GalleryController::class)
->only(['index', 'create', 'edit']);
GalleryController.php：
public function edit($gallery) // 参数名必须与资源名一致（小写单数）
{
$data = Gallery::findOrFail($gallery); // 自动模型绑定或手动查找
return inertia('backend/cms-gallery-edit', ['data' => $data]);
}
前端链接需严格匹配资源路由格式：
<inertia-link v-if="options.edit" :href="`/admin/gallery/${data.id}/edit`">
编辑图库
</inertia-link>
生成的 URL 示例：/admin/gallery/1/edit ✅
方式二：自定义参数名为 id
若坚持在 URL 中显示 id（如 /admin/gallery/{id}/edit），需显式声明参数映射：
web.php：
Route::resource('/admin/gallery', GalleryController::class)
->only(['edit'])
->parameters(['gallery' => 'id']); // 将资源名 'gallery' 映射为参数 'id'
此时控制器方法可使用 $id 参数：
public function edit($id)
{
$data = Gallery::findOrFail($id);
return inertia('backend/cms-gallery-edit', ['data' => $data]);
}
? 提示：->parameters() 的键是资源名（小写单数），值是你希望的 URL 参数名。Laravel 会自动将该参数注入控制器方法。
❌ 常见错误排查
- 404 错误根源：前端仍使用 /admin/gallery/edit/1 —— 此路径不匹配任何资源路由，Laravel 无法识别；
- 参数名不一致：如路由映射 ['gallery' => 'id']，但控制器写 function edit($gallery)，将导致参数未注入；
- 未启用对应动作：->only() 中遗漏 'edit'，或未运行 php artisan route:list 验证实际注册的路由。
✅ 最佳实践建议
- 优先采用 Laravel 默认约定（{gallery}），语义更清晰，且支持隐式模型绑定；
- 使用 findOrFail() 替代 find()，避免空模型引发后续错误；
- 在开发中执行 php artisan route:list --name=gallery 快速确认路由是否已注册及 URI 格式；
- Inertia 前端应动态拼接 ID，而非硬编码路径（如 ${item.id}），确保可扩展性。
通过以上配置，你就能在资源路由中精准控制 ID 参数的命名与位置，兼顾规范性与可读性。
