ThinkPHP6.x控制器必须规范处理请求与响应：一、通过方法参数注入Request对象并用param()获取数据；二、响应须return返回，优先用json()等快捷方法；三、需精确控制时链式调用code()和header()；四、重定向统一用redirect()；五、文件下载须规避前置输出并用rawurlencode()处理中文名。
如果您在编写 ThinkPHP6.x 控制器时发现请求数据无法正确获取、响应内容未按预期格式输出或状态码/头信息丢失，则可能是由于未遵循框架对控制器方法中请求处理与响应输出的规范要求。以下是符合 ThinkPHP6.x 官方设计意图的标准写法步骤：
一、控制器方法参数注入 Request 对象
通过构造函数或操作方法参数自动注入 Request 实例，确保请求对象为框架容器管理的单例，避免手动 new 或静态调用导致生命周期异常或中间件上下文丢失。
1、在控制器操作方法签名中直接声明 Request 类型参数，框架自动解析并注入当前请求实例。
2、使用该参数调用 param() 获取全部或指定键名的请求数据，支持 GET、POST、PUT、DELETE 等所有 HTTP 方法提交的数据合并解析。
立即学习“PHP免费学习笔记（深入）”；
3、对敏感字段执行显式过滤，例如 $request->param('username', '', 'htmlspecialchars')，防止 XSS 风险。
二、响应必须通过 return 显式返回响应对象或原始值
ThinkPHP6.x 的响应机制默认不自动发送输出，控制器方法必须以 return 语句结束，由框架统一调用 send() 方法完成 HTTP 响应；若使用 exit/die 或前置 echo 将中断流程并导致响应体为空。
1、返回字符串时，框架自动封装为 \think\Response 实例，默认 Content-Type 为 text/html；适用于简单 HTML 片段或调试输出。
2、返回数组时，若请求头包含 application/json 或 Accept: application/json，框架自动转为 JSON 格式响应；但为明确语义，应优先使用 json() 快捷方法。
3、调用 json($data) 时，框架自动设置 Content-Type 为 application/json; charset=utf-8，并启用 UTF-8 中文不转义（JSON_UNESCAPED_UNICODE）。
三、显式构造响应对象并配置状态码与头信息
当需要精确控制 HTTP 状态码、自定义响应头或混合多种响应特性时，应使用 response()、json()、redirect() 等快捷方法链式调用，避免手动 new Response 类实例造成 MIME 类型遗漏或编码错误。
1、设置非 200 状态码：return json($data)->code(201) 或 return response($html)->code(404)。
2、添加自定义响应头：return json($data)->header(['X-Request-ID' => uniqid(), 'Cache-Control' => 'no-cache'])。
3、强制覆盖默认 Content-Type：return response($xmlString)->contentType('application/xml; charset=utf-8')。
四、重定向必须使用 redirect() 并区分内外路径
页面跳转需统一使用 redirect() 方法生成 \think\response\Redirect 实例，确保 Location 头正确写入且兼容 CLI 与 HTTP 环境；直接 header("Location:...") 会绕过框架中间件与事件监听，导致 session、日志等失效。
1、站外跳转：return redirect('https://example.com')->code(302)。
2、站内 URL 跳转：return redirect('user/profile')，路径自动补全为当前域名下的完整路由地址。
3、携带临时 Session 数据跳转：return redirect('order/success')->with('message', 订单创建成功)。
五、文件下载响应需规避前置输出并处理中文文件名
response()->download() 依赖 header() 发送 Content-Disposition，任何前置空格、BOM、var_dump() 或 echo 都会导致“headers already sent”错误；同时中文文件名在不同浏览器中解析规则不一致，必须编码处理。
1、确认控制器方法中无任何调试输出语句，包括注释前的空白行或 UTF-8 BOM 字节。
2、获取文件绝对路径后，校验文件存在且可读：$path = app()->getRuntimePath() . 'export/data.xlsx'; if (!is_file($path)) { abort(404); }。
3、使用 rawurlencode() 编码文件名：return response()->download($path, rawurlencode('销售报表2026.xlsx'))->header('Cache-Control', 'no-cache');。
