唯一推荐且安全的方式是通过方法参数类型提示注入ResponseInterface；因其为协程上下文绑定的短生命周期对象，从容器get或new会导致数据错乱、空响应或写入错误连接。
直接通过方法参数类型提示注入，是唯一推荐且安全的方式。Hyperf 的 ResponseInterface 是协程上下文绑定的短生命周期对象，不能从容器中 get()，也不能用 new 实例化，否则会引发数据错乱或空响应。
为什么不能从 DI 容器里 get(ResponseInterface::class)
Hyperf 的 ResponseInterface 实现类（如 Hyperf\HttpServer\Response）被注册为「协程单例」，但它的实际状态（如 headers、body、status）只对当前请求有效。若在控制器外提前 $container->get(ResponseInterface::class)，拿到的是未初始化或已被复用的对象，->json() 等方法可能静默失败，或把响应写到错误的连接上。
- 常见错误现象：
return $response->json([...])返回空白页，Network 面板显示 200 但无 body - 根本原因：该
$response实例未关联当前请求的 SwooleResponse句柄 - 正确做法：仅通过控制器方法参数声明获取，框架自动注入当前协程有效的实例
控制器中获取 ResponseInterface 的两种合法写法
必须确保类型提示为 Hyperf\HttpServer\Contract\ResponseInterface（接口），而非具体实现类。框架会自动解析并注入当前请求对应的响应对象。
- 方式一：方法参数注入（推荐）
public function index(Hyperf\HttpServer\Contract\ResponseInterface $response): Psr\Http\Message\ResponseInterface { return $response->json(['code' => 0, 'data' => []]); } - 方式二：构造函数注入 + 属性保存（仅限需要跨多个方法复用时）
private Hyperf\HttpServer\Contract\ResponseInterface $response; public function __construct(Hyperf\HttpServer\Contract\ResponseInterface $response) { $this->response = $response; }⚠️ 注意：该属性只能在同一次请求生命周期内使用，不可缓存或跨协程共享
容易踩的坑：混用 Swoole 原生 Response 或手动 new
有人尝试直接操作 Swoole\Http\Response，或写 new Hyperf\HttpServer\Response(...)，这会导致严重问题：
-
Swoole\Http\Response是底层句柄，没有 PSR-7 兼容层，调用$response->header()后无法再链式调用->json() -
new Hyperf\HttpServer\Response绕过协程上下文绑定，->withHeader()等操作不会生效，最终响应为空 - 中间件里若提前返回了
ResponseInterface，控制器方法甚至不会执行——所以不要在控制器里“造”响应，只负责“返回”它
最易被忽略的一点：如果控制器方法返回值类型声明不是 Psr\Http\Message\ResponseInterface（比如写成 void 或 string），即使你调用了 $response->json()，框架也不会将其作为 HTTP 响应发出——它只是个普通对象调用，结果被丢弃了。
