ThinkPHP调用第三方接口报错怎么完整记录日志-ThinkPHP-PHP中文网

thinkphp 6 的 http 类请求失败时默认不记录完整错误详情，需手动捕获 requestexception 等异常并结构化记录请求、响应及脱敏后敏感信息。

thinkphp调用第三方接口报错怎么完整记录日志

ThinkPHP 6 的 `Http` 类请求失败时默认不记录错误详情

直接用 think\facade\Http::get() 或 post() 调第三方接口，一旦网络超时、SSL 验证失败、返回非 2xx 状态码，Http 类默认只抛出异常，但不会把原始响应体、请求头、错误码等写入日志。你看到的可能只是 ClientException 或 ServerException，没有上下文，根本没法定位是对方挂了、证书过期，还是你传了非法参数。

手动捕获异常并记录完整请求/响应信息

必须在 try...catch 中显式提取关键字段，不能只打 $e->getMessage()。尤其注意：异常对象本身可能不含响应体（比如 DNS 失败时根本没发出去），所以得区分“请求发出前”和“请求发出后”的错误类型。

think\exception\HttpException 和 GuzzleHttp\Exception\RequestException 是常见父类，优先 catch 这两个
用 $e->getRequest() 取原始 Request 对象，调 getMethod()、getUri()、getBody()->getContents()（注意：body 可能已读取过，需提前保存）
用 $e->getResponse() 取响应（仅当请求已发出且有响应时存在），再取 getStatusCode()、getReasonPhrase()、getBody()->__toString()
日志建议用 Log::error()，内容结构化，例如："[http] req: GET /api/v1/user, status: 0, msg: cURL error 7: Failed to connect"

推荐封装一个带日志的 HTTP 客户端

别每次调第三方都手写 try/catch。在 app/common/HttpLogger.php 里写个静态方法，统一处理请求、记录、重试（可选）。关键是把 body 提前缓存——Guzzle 的 Stream 是单次读取的，不缓存就丢了。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

use think\facade\Log;
use think\facade\Http;
use GuzzleHttp\Exception\RequestException;

class HttpLogger
{
    public static function request($method, $url, $options = [])
    {
        try {
            // 缓存原始 body，防止后续无法读取
            $body = $options['body'] ?? null;
            if (is_string($body)) {
                Log::info("[http] req: {$method} {$url}, body: " . substr($body, 0, 500));
            }

            return Http::{$method}($url, $options);
        } catch (RequestException $e) {
            $req = $e->getRequest();
            $res = $e->getResponse() ?: null;
            $status = $res ? $res->getStatusCode() : 0;
            $msg = $e->getMessage();

            Log::error("[http] req: {$method} {$url}, status: {$status}, msg: {$msg}");

            if ($res) {
                Log::error("[http] res body: " . substr((string) $res->getBody(), 0, 1000));
            }

            throw $e;
        }
    }
}

日志文件权限和敏感信息过滤要提前检查

线上环境如果日志目录不可写，或者 log.level 设成 warning，那 error() 日志也写不进去。另外，第三方接口常带 token、手机号、身份证号，直接打全量 body 会违规。必须做脱敏：

对 URL 中的 query 参数，用 parse_url($url, PHP_URL_QUERY) 解析后过滤 token、sign 等键
对 JSON body，先 json_decode($body, true)，再用 array_walk_recursive 清洗敏感字段值（如替换为 ***）
避免在日志里记录 Authorization 请求头，可用正则匹配并替换：preg_replace('/Authorization:\s*[^\r\n]+/', 'Authorization: ***', $headers)