PHP 7.4 调用 Gemini 时本地与服务器结果不一致，主因是请求链路中环境差异：一是请求头或 JSON payload 被代理/WAF/PHP 静默修改；二是 Host/Origin 头遭反代或网关篡改；三是 mbstring 设置、编码参数或 post_max_size 等 PHP 运行时配置不一致导致 JSON 截断或损坏。
PHP 7.4 调用 Gemini 时本地和服务器返回结果不一致，通常不是 Gemini API 本身的问题，而是请求链路中环境、配置或中间处理环节存在隐性差异。核心原因集中在三类：HTTP 请求构造不一致、服务端拦截/改写、以及 PHP 运行时行为差异。
一、请求头与 payload 格式被静默修改
Gemini 对请求体（尤其是 options、scale、state 字段）非常敏感。若服务器环境中的代理、WAF、反向代理（如 Nginx）或 PHP 的 cURL 封装层对 JSON payload 做了自动格式化、空格压缩、控制字符清理或字段重排序，可能导致 payload 被 Gemini 后端判定为“非法”，触发静默丢弃机制——返回 {"results":[]} 或空响应，而本地直连无此问题。
- 检查是否在服务器端使用了非标准的 JSON 编码方式（如未设
JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES） - 确认
Content-Type是否严格为application/json，且无多余空格或 BOM - 用
curl -v在服务器上手动复现请求，对比本地curl -v输出，逐行比对请求头与原始 body
二、网络中间件篡改 Host 或 Origin 头
Gemini 部分接口会校验 Origin 或 Host 头用于跨域或租户识别。本地开发常直连 API，而服务器可能经由 Nginx 反代、CDN 或企业网关：
- Nginx 若未显式透传
Host：proxy_set_header Host $host;，Gemini 可能收到localhost或 IP，触发策略拦截 - 某些云 WAF 会剥离或重写
Origin，导致带 credentials 的请求被拒绝，但错误不返回 4xx，只给空结果 - 验证方法：在 PHP 中打印
getallheaders()（或apache_request_headers()），确认发出的请求头与本地一致
三、PHP 7.4 环境差异引发的编码/截断问题
服务器与本地的 mbstring.func_overload、default_charset、iconv 设置不同，可能导致 JSON 字符串在传输前就被损坏：
立即学习“PHP免费学习笔记（深入）”；
- 例如服务器启用了
mbstring.func_overload = 2，会使strlen()返回字符数而非字节数，若代码中用它计算 JSON body 长度并手动设置Content-Length，就会错位 - 服务器
post_max_size或max_input_vars过小，导致大 prompt 被截断，Gemini 收到不完整 JSON，解析失败后静默返回空 - 排查建议：在发送前用
json_last_error()和json_last_error_msg()检查编码是否成功；用mb_strlen($json, '8bit')替代strlen()获取真实字节长度
不复杂但容易忽略
