ThinkPHP 协议判断错误导致 URL 生成为 http 而非 https，主因是反向代理未透传 HTTPS 或 X-Forwarded-Proto 头；需配置 Nginx/Apache 透传、设置 trusted_proxies、或直接配置 app_host 强制协议。
ThinkPHP 获取网页完整路径时协议判断出错，本质是框架在拼接 http:// 或 https:// 时没识别到真实请求协议，导致生成的 URL（如跳转链接、资源地址、API 回调地址）变成 http://xxx 而不是预期的 https://xxx，尤其在反向代理（Nginx / Apache + HTTPS 终止）或云服务（如阿里云 SLB、腾讯云 CLB）后常见。
检查 $_SERVER 中协议相关变量是否被正确传递
ThinkPHP 默认通过 $_SERVER['HTTPS'] 或 $_SERVER['HTTP_X_FORWARDED_PROTO'] 判断协议。但反向代理常会屏蔽或未透传这些字段：
-
$_SERVER['HTTPS']在 Nginx 后端 PHP 中通常为空（即使前端是 HTTPS），除非你在 Nginx 配置中显式设置：fastcgi_param HTTPS on; -
$_SERVER['HTTP_X_FORWARDED_PROTO']需代理层主动添加，例如 Nginx 配置中加：proxy_set_header X-Forwarded-Proto $scheme; - 若用 Apache + mod_proxy，需确保
ProxyPreserveHost On和RequestHeader set X-Forwarded-Proto expr=%{REQUEST_SCHEME}e
强制指定应用协议与域名
当环境不可控（如多级代理、容器网络）时，不依赖服务器变量更可靠：
- 在
config/app.php中设置：'app_host' => 'https://yourdomain.com',
该配置会覆盖自动检测，所有url()、redirect()等生成的链接均以此为准 - 若需动态适配（如开发环境 HTTP、生产环境 HTTPS），可在
.env中定义：APP_URL=https://yourdomain.com
然后在配置中读取：'app_host' => env('APP_URL', 'http://localhost'),
验证并修复中间件/入口层协议识别逻辑
某些部署场景下，$_SERVER 变量被框架早期中间件误改或未初始化：
立即学习“PHP免费学习笔记（深入）”；
- 检查是否启用了自定义中间件（如处理跨域、日志、安全头），确认其未意外覆盖
$_SERVER['HTTPS']或清空HTTP_X_FORWARDED_PROTO - 在
public/index.php最顶部临时加一行调试：var_dump($_SERVER['HTTPS'] ?? null, $_SERVER['HTTP_X_FORWARDED_PROTO'] ?? null); die();
看实际值是否符合预期 - ThinkPHP 6.1+ 支持在
config/app.php中配置：'trusted_proxies' => ['127.0.0.1', '192.168.0.0/16'],
启用后框架会信任这些 IP 发来的X-Forwarded-*头，否则直接忽略
微信回调等第三方集成场景特别注意
网页授权、JS-SDK、支付回调等对协议极其敏感，错用 http 会导致签名失败或静默拒绝：
- 公众号后台填写的
redirect_uri必须与 ThinkPHP 实际生成的协议完全一致（含https://） - 不要在控制器里手动拼
http或https，统一用url('callback/wechat', [], true)（第三个参数true表示强制绝对 URL） - 若使用
Url::build()，确保其底层也读取了正确的app_host配置
