Laravel怎么实现下拉联动功能_Laravel如何编写后端API【示例】-Laravel-PHP中文网

下拉联动后端应采用懒加载+分层id关联设计：省级只返回id/name；选省后按province_id查市级；再按city_id查区级；禁用with()预加载和totree()，路由分三层。

laravel怎么实现下拉联动功能_laravel如何编写后端api【示例】

下拉联动的后端数据结构怎么设计才不卡前端

Laravel 做下拉联动，核心不是写多少接口，而是让前端能按需拿最小数据。常见错误是把所有省市区一次性全查出来塞进 JSON，结果首屏加载慢、内存溢出、前端渲染卡顿。

关键在「懒加载 + 分层 ID 关联」：省级列表只返回 id 和 name；选中某省后，前端用该省的 id 请求市级列表，后端只查 province_id = ? 的城市；同理区县只依赖上一级 city_id。

不要用 Eloquent 的 with() 预加载三级数据——那等于把全国 4 万多个行政区划一次吐给前端。也不要用 toTree() 构建嵌套数组，前端根本不需要完整树形结构，它只要平铺列表。

示例路由：

Route::get('/api/provinces', [AreaController::class, 'index']);
Route::get('/api/cities', [AreaController::class, 'citiesByProvince']);
Route::get('/api/districts', [AreaController::class, 'districtsByCity']);

Laravel API 接口怎么避免 N+1 查询和空数据报错

citiesByProvince 方法里最容易掉坑：没加 whereNotNull('province_id')，导致查出一堆 null 城市；或者直接 City::where('province_id', $request->province_id)->get() 却忘了验证 $request->province_id 是合法整数。

必须做三件事：

用 filter_var($id, FILTER_VALIDATE_INT) 或 Laravel 的 $request->integer('province_id') 强制转整型，防止 SQL 注入或空字符串查询
加 where('status', 1)（如果你有启用状态字段），不然前端会看到被禁用的城市
用 select('id', 'name') 明确字段，别用 *，减少传输体积

如果城市表有软删除，记得加 withTrashed() 或明确排除：whereNull('deleted_at')，否则前端选不到已逻辑删除但数据库还存着的记录。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

为什么前端总收不到 200 以外的错误提示

Laravel 默认对 404、422 等错误返回的是 HTML 页面（开发环境）或空响应（生产环境），而前端 JS 的 fetch 或 axios 期望的是 JSON 格式错误体，比如 {"message": "Province not found"}。

解决办法不是改前端，是统一后端响应格式：

在 app/Exceptions/Handler.php 的 render() 方法里，对 API 路由加判断：if ($request->is('api/*')) { ... }
对 ModelNotFoundException，手动 return response()->json(['message' => 'Province not found'], 404)
对验证失败（ValidationException），默认已返回 JSON，但字段名是 errors，前端要适配这个 key，别硬写成 error

漏掉这点，前端永远在 catch 里打 log：「TypeError: Cannot read property 'message' of undefined」。

API 返回的 ID 字段要不要转成字符串

要，尤其当你的主键是 bigInteger（比如 MySQL 的 BIGINT UNSIGNED）且值超过 2^53 - 1 时，JavaScript 会丢失精度。用户看到「北京市」ID 变成 11000000000000000，点提交后后端查不到——因为实际是 11000000000000001。

Laravel 默认序列化整型 ID 不做处理。解决方案有两个：