根本原因是swoole中response->header()必须在响应体发送前调用，且不能晚于end()或write()首次调用；传统header()函数在常驻内存模型下完全无效，必须改用响应对象方法并确保正确时机与链式返回。
response->header() 调用后响应头没出现
根本原因是：Swoole 的 response->header() 必须在响应体发送前调用，且不能晚于 response->end() 或 response->write() 的首次调用。一旦底层开始写入 HTTP 响应体（比如调用了 end()、write() 或返回了字符串内容），后续再调用 header() 就完全无效——不是报错，而是静默丢弃。
常见触发场景：
- 在控制器方法末尾先
return 'hello';，再试图补$response->header(...)—— 此时框架已自动调用end()，header 失效 - 使用
response->write()流式输出时，在第一次write()之后才设 header - 在中间件里调用了
$next($request)得到$response，但没链式返回新 response（如漏掉->withHeader()后的return）
Webman/ThinkPHP 中用 header() 函数完全没反应
因为 Swoole 是常驻内存模型，传统 PHP 的 header() 函数依赖 CGI/SAPI 层转发，而 Swoole 直接构造 HTTP 报文，绕过了 PHP 运行时的 header 缓存机制。header('Access-Control-Allow-Origin: *') 这类写法在 Webman、ThinkPHP+Swoole 环境下纯属无效代码，不会报错，但也不会出现在最终响应中。
必须改用响应对象方法：
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
- Webman：用
$response->withHeader()（返回新实例，必须return） - ThinkPHP（含 think-swoole）：用
$response->header()（原地修改，无需返回，但必须在end()前） - 原生 Swoole Server：用
$response->header()，注意第三个参数$ucwords默认为true，会自动格式化 key（如转成Access-Control-Allow-Origin）
设置了 header 但浏览器 Network 面板看不到
可能被中间件或框架层覆盖。尤其注意：
- CORS 场景下，如果
CorsMiddleware没注册进config/middleware.php，或路由没加->middleware('api')，那中间件根本没执行 - 多个中间件都设了同名 header（如都设
Access-Control-Allow-Origin），后执行的会覆盖前面的 —— CORS 中间件要放在鉴权、日志等可能提前返回响应的中间件之后 - Nginx 拦截了 OPTIONS 请求，导致预检失败，浏览器直接不发后续请求；此时即使 PHP 层 header 设置正确，你也看不到它
- 带 Cookie 的请求启用了
credentials: 'include'，但服务端仍返回Access-Control-Allow-Origin: *—— 浏览器强制拒绝，连响应头都不展示
HTTP/2 下 header 行为有隐藏差异
开启 open_http2_protocol 后，虽然 response->header() API 不变，但底层帧编码逻辑不同：
-
Content-Length头会被自动忽略或覆盖，HTTP/2 不依赖它 -
Connection、Keep-Alive、Transfer-Encoding等 HTTP/1.1 特有头会被自动过滤或禁用 - 若你手动设置了
Content-Encoding: gzip，而同时又开了http_compression => true，可能导致响应体损坏 —— HTTP/2 自带 HPACK 压缩，禁止重复压缩 - 伪头（如
:method、:path）由协议栈自动生成，不能通过header()设置，否则会触发协议错误
最易被忽略的是 timeout 含义变化：HTTP/2 中它控制整个流生命周期，不是单次请求耗时；首包延迟高（如 LLM 流式响应）时，不调大 timeout 会导致连接被静默 RST。
