CodeIgniter 4 的 $this->request->headers() 返回 Header 对象数组而非字符串，需调用 getValue() 或 getHeaderLine() 获取实际值；键名自动小写标准化，重复头用 getValues() 获取全部，代理环境需配置透传自定义头。
$this->request->headers() 返回的是 CodeIgniter\HTTP\Header 对象数组，不是原始字符串值 —— 这是绝大多数人第一次读不到头信息的根本原因。
为什么 $this->request->headers() 看起来是空的
调用 $this->request->headers() 后直接 print_r() 或 var_dump()，你会看到一堆 CodeIgniter\HTTP\Header 实例，但没有值。这是因为每个 Header 对象封装了名称、值、是否重复等元信息，不调用方法就拿不到实际字符串。
- Header 对象本身不重载
__toString()，所以(string) $header会失败或返回空 - 框架不会自动把
getValue()结果塞进数组键里，必须显式调用 - 某些反向代理（如 Nginx + FastCGI）可能过滤掉自定义头，比如
X-Api-Key，需检查服务器配置是否透传
正确提取所有请求头值的写法
必须遍历并调用 getValue()，不能直接取数组值：
$headers = $this->request->headers();
$header_values = [];
foreach ($headers as $key => $header) {
$header_values[$key] = $header->getValue();
}
// 现在 $header_values 是普通关联数组，如 ['content-type' => 'application/json', 'x-request-id' => 'abc123']
- 注意键名是小写的（CI4 自动标准化），
X-Request-ID和x-request-id都会变成x-request-id - 如果某个头出现多次（如
Set-Cookie），getValue()默认只返回第一个；需要全部值请改用getValues()（返回数组） - 想读单个头？直接用
$this->request->getHeaderLine('authorization')，它内部已调用getValue()并忽略大小写
读取特定头时的常见陷阱
别用 $_SERVER 手动拼接，CI4 的 getHeaderLine() 和 getHeader() 已处理好 CGI/FastCGI 环境差异（如 HTTP_X_FORWARDED_FOR 转 X-Forwarded-For）。
-
$this->request->getHeaderLine('authorization')→ 返回字符串，适合 Bearer 解析 -
$this->request->getHeader('content-type')→ 返回Header对象，可链式调用->getValue()或->hasValue('application/json') - 若头名含下划线（如
X_API_KEY），PHP-CGI 默认转成空格或丢弃；Nginx 需加underscores_in_headers on;，否则 CI4 根本收不到 - 测试时用 curl 发送头，别依赖浏览器开发者工具“复制为 curl”——它有时漏掉
-H或编码错误
Header 对象的存在不是为了增加复杂度，而是为了统一处理重复头、大小写归一、安全过滤等边界情况。跳过对象直接操作 $_SERVER 短期能跑通，但遇到代理、负载均衡或合规审计时大概率翻车。
