react native 的 fetch api 不支持含下划线（_）的自定义请求头字段名，需改用标准命名（如 authorization），并同步调整后端 php 对应的 header 解析逻辑。
react native 的 fetch api 不支持含下划线（_）的自定义请求头字段名，需改用标准命名（如 authorization），并同步调整后端 php 对应的 header 解析逻辑。
在 React Native 开发中，一个常见却容易被忽视的问题是：自定义 HTTP 请求头（Header）字段名中若包含下划线（_），将无法被正确发送或识别。这正是你遇到“Postman 正常、React Native 失败”的根本原因。
? 问题根源：React Native 的 Header 命名限制
React Native 底层基于原生平台（iOS/Android）的网络栈（如 iOS 的 NSURLSession、Android 的 OkHttp），而这些平台默认过滤或忽略含下划线的自定义 Header 字段名——这是出于 HTTP/1.1 规范兼容性与安全策略的考虑（RFC 7230 明确建议 Header 字段名仅使用字母、数字、连字符 -，不推荐下划线）。因此，即使你在 JS 中写：
const response = await fetch('https://api.example.com/data', {
headers: {
'AUTHORIZATION_API': 'myKEY' // ❌ React Native 会静默丢弃该 header
}
});该 Header 实际不会出现在发出的 HTTP 请求中，导致后端完全收不到。
✅ 正确做法：使用合规命名 + 后端适配
1. 前端（React Native）改用标准字段名
推荐使用语义清晰、符合惯例的名称，例如：
const response = await fetch('https://api.example.com/data', {
method: 'GET',
headers: {
'Authorization': 'myKEY', // ✅ 合法、通用、可被正确传递
// 或根据业务需要使用其他合规名，如 'X-Api-Key', 'X-Auth-Token'
}
});? 注意：Authorization 是标准 HTTP Header，无需加 HTTP_ 前缀；React Native 会自动将其映射为 HTTP_AUTHORIZATION 供 PHP 的 getallheaders() 或 getHeaders() 使用。
2. 后端（PHP）同步更新解析逻辑
PHP 的 $request->getHeaders()（Laravel）或 getallheaders() 返回的键名，会自动将原始 Header 名转为大写，并添加 HTTP_ 前缀。例如：
- 请求头 Authorization: myKEY → PHP 中键名为 HTTP_AUTHORIZATION
- 请求头 X-Api-Key: abc123 → 键名为 HTTP_X_API_KEY
因此，原代码：
// ❌ 错误：试图读取不存在的 'HTTP_AUTHORIZATION_API'
if ($data_validation->validate_authentication_api($request_header['HTTP_AUTHORIZATION_API'][0], $response)) {应改为：
// ✅ 正确：匹配前端实际发送的 'Authorization' header
$authHeader = $request_header['HTTP_AUTHORIZATION'][0] ?? null;
if ($data_validation->validate_authentication_api($authHeader, $response)) {
// 执行业务逻辑
}3. 验证方式（快速排查）
- 在 React Native 中打印请求头（开发阶段）：
console.log('Sending headers:', { 'Authorization': 'myKEY' }); - 在 PHP 端打印全部 Header 调试：
error_log(print_r(getallheaders(), true)); // 查看实际收到哪些 header
⚠️ 注意事项与最佳实践
- 避免自定义 Header 使用下划线：不仅是 React Native，部分 Web 容器（如 Nginx 默认配置）也会过滤 _ 字段，应统一采用 - 分隔（如 X-Auth-Api-Key）。
- 区分大小写：PHP 中 HTTP_AUTHORIZATION 是全大写，注意数组键名严格匹配。
- 跨平台一致性：若同时支持 Web（浏览器）、React Native、Flutter，务必统一 Header 命名规范，降低集成成本。
- 安全性提醒：Authorization 字段通常用于认证，请确保传输走 HTTPS，并避免在日志中明文记录敏感值。
通过以上调整，你的 React Native 请求即可与 Postman 行为完全一致，稳定通过认证校验。记住：Header 字段名不是任意字符串，而是受协议与运行时双重约束的标准化接口——遵循规范，远胜于绕过限制。
