ThinkPHP 8.0 开发 API 需绕过 Web 思维：路由须显式绑定跨域/鉴权中间件；验证失败需返回 JSON（继承基类或全局捕获异常）；PUT/DELETE 请求在内置服务器中 body 解析异常，应切 Nginx/Apache 测试；模型输出前必须 toArray()，字段筛选用数组。
ThinkPHP 8.0 实现 API 接口开发不难，但关键细节容易被忽略，导致返回 HTML、跨域失败、参数收不到或路由不生效。核心是绕过传统 Web 页面思维，用好内置组件并修正默认行为。
路由定义要显式绑定中间件
Resource 路由（如 Route::resource('users', 'api/UserController')）自动生成标准 REST 路径，但不会自动加载任何中间件，包括跨域、鉴权、日志等。
- 必须在
route/app.php中显式追加->middleware(['allow_cross_domain', 'auth']) - 若用注解路由（
#[Resource('user')]），需在控制器类顶部加#[Middleware(['allow_cross_domain'])] - 中间件名必须与
config/middleware.php中注册的键名一致，不是类名
验证失败必须返回 JSON
调用 $this->request->validate() 或验证器后，校验失败默认抛出 ValidateException 并渲染 HTML 页面——这对 API 是致命错误。
- 推荐方案：所有 API 控制器继承统一基类
ApiBaseController，在initialize()中设$this->failValidate = true，并重写validateFail()方法，手动返回json(['code'=>400, 'msg'=>'参数错误', 'data'=>[]]) - 替代方案：在
app/exception/Handle.php的render()方法中拦截ValidateException，统一构造 JSON 响应 - 验证器内避免
throw_exception，改用return false+ 手动组装错误数组
开发环境注意 PUT/DELETE 请求体问题
php think run 启动的内置服务器无法正确解析 PUT/DELETE 请求的原始 body，$this->request->put() 或 $this->request->param() 可能为空。
立即学习“PHP免费学习笔记（深入）”；
- 临时解决：前端发请求时用 POST +
_method=PUT（需启用method_filter中间件） - 真实测试务必切换到 Nginx 或 Apache，它们能正常传递非 GET/POST 的请求体
- 上线前必须验证，不能依赖开发服务器表现
模型数据输出前必须 toArray()
ThinkORM 3.0 返回的是对象实例，直接 json($user) 会触发序列化异常或泄露内部属性。
- 控制器中输出前务必调用
$user->toArray()或$list->toCollection()->toArray() - 字段筛选要用数组：
$model->field(['id','name','email'])->select()，字符串参数会被静默忽略 - 查无结果时返回
null，判空建议用空安全操作符：if ($user?->id)
