Hyperf控制器中不能直接用$response->withStatus(400)后不接收返回值，因ResponseInterface不可变，必须链式调用或显式赋值；json()默认返回200，需手动设状态码；WebSocket中设HTTP状态码无效。
Hyperf控制器里不能直接用return $response->withStatus(400)？
能，但必须在返回前调用，且不能依赖框架自动推导。Hyperf 的 ResponseInterface 是不可变对象，withStatus() 返回的是新实例，原对象不变。常见错误是写了 $response->withStatus(400) 却没接住返回值，最后 return 的仍是原始 200 响应。
正确写法是链式调用或显式赋值：
return $response->withStatus(400)->json(['message' => '参数错误']); // 或 $response = $response->withStatus(400); return $response->json(['message' => '参数错误']);
- 状态码必须在
return前设置，响应头一旦发送（比如已调用过write()或end()），再设withStatus()会无效 - 若用了
@Middleware或自定义中间件，确保它没提前终止响应或覆盖状态码 - 协程环境下，不要在异步任务里操作当前请求的
$response，上下文已丢失
用HttpResponseException抛异常比手动设状态码更稳妥？
是的，尤其适合业务校验失败场景。Hyperf 内置的 Hyperf\HttpServer\Exception\HttpResponseException 会自动触发异常处理器，并携带你指定的状态码和响应体，避免手动拼接时漏掉 withStatus() 或传播控制。
示例：
use Hyperf\HttpServer\Exception\HttpResponseException;
use Psr\Http\Message\ResponseInterface;
throw new HttpResponseException(
$response->withStatus(422)->json(['errors' => $validator->errors()->messages()])
);
- 这种方式天然绕过控制器后续逻辑，语义清晰：这不是“正常返回”，而是“主动拒绝”
- 异常会被
HttpExceptionHandler捕获，日志、监控、统一格式都自动生效 - 注意不要在
isValid()返回true的自定义异常处理器里又 throw 同类异常，容易循环
为什么$this->response()->json()总是返回 200？
因为 Hyperf\HttpServer\Response 的 json() 方法默认不改状态码，它只负责序列化和设 Content-Type。它的签名是 public function json($data, int $status = 200, array $headers = [])，但框架里多数快捷方法（如 success()、fail()）并未透传 $status 参数。
所以别依赖快捷方法设状态码，直接用底层接口：
return $this->response()->withStatus(401)->json(['message' => '未授权']); // 而不是 return $this->response()->json(['message' => '未授权']); // 状态码永远是 200
- 如果项目中大量使用统一响应结构，建议封装一个
respond()工具方法，强制传入 status - 检查是否启用了
Hyperf\Contract\ResponseInterface的代理，某些 AOP 配置可能劫持了json()调用 - 验证响应是否真被发出：用 curl -I 看 header，别只信浏览器开发者工具的 preview
WebSocket控制器里设 HTTP 状态码有意义吗？
没有。WebSocket 连接建立后走的是帧通信，不再走 HTTP 协议栈。withStatus() 对 WebSocket 的 onMessage 或 onOpen 处理器完全无效，调用它不会报错，但也不会起作用。
WebSocket 场景下，错误应通过业务约定字段传递，例如：
// 正确做法：发 JSON 消息体带 code 字段 $this->response()->send(json_encode(['code' => 4001, 'message' => '登录态失效']));
- 握手阶段（
onHandShake）可以设 HTTP 状态码，那是 HTTP 升级请求，属于合法时机 - 连接建立后所有通信都是二进制或文本帧，状态码概念已退出舞台
- 若需模拟“HTTP 式错误反馈”，必须由前端解析消息体中的
code字段，和服务端约定好语义
