请求头报Array to string conversion错误，Laravel创建webhook失败如何解决

根因说明 #

你遇到的数组转字符串报错是因为Laravel的Http客户端设置请求头时，要求header值必须为字符串格式，你传给X-MANAGER-TOKEN的$clientInformation["meta"]["accessToken"]实际是数组类型，Laravel底层尝试将其转为字符串时触发了错误。

排查步骤 #

• 后端先验证入参格式：在Http请求代码前插入调试代码dd($clientInformation["meta"]["accessToken"])，确认该值的类型和结构，如果输出为数组即可确定问题来源。
• 前端排查this.meta结构：在前端赋值accessToken前执行console.log(this.meta)，确认你需要的token字符串是在该变量的哪个层级，你当前的代码是直接把整个this.meta对象/数组赋值给了accessToken字段，没有提取实际的token字符串。

修复方案 #

前端修复（推荐） #

确认this.meta中token的实际路径后修正赋值逻辑，保证传给后端的accessToken是纯字符串：

// 示例：如果token存在this.meta的token字段下
this.clientForm.is_third_party = true;
this.clientForm.meta = { accessToken: this.meta.token };

// 示例：如果this.meta本身就是存token的数组，取下标对应值
// this.clientForm.meta = { accessToken: this.meta[0] };

后端兼容修复（可选） #

可以在后端增加参数校验逻辑，避免同类问题再次出现：

try {
    $accessToken = $clientInformation["meta"]["accessToken"];
    // 校验参数类型
    if (is_array($accessToken)) {
        // 业务兼容写法：根据实际结构提取token，比如取数组中token字段
        // $accessToken = $accessToken['token'] ?? '';
        // 或者直接抛出明确的参数错误
        throw new \InvalidArgumentException("accessToken参数格式错误，要求字符串，收到数组");
    }

    $response = Http::withHeaders(["X-MANAGER-TOKEN" => $accessToken])
        ->withToken(config("hello.ACCESS_TOKEN"))
        ->post(
            config("hello.BASE_URL") . "/managers/webhooks",
            [
                "event" => 'order.status.update',
                "target_url" => config("app.url") . "/api/hello/validate",
                "original_id" => random_int(0, 9999999999),
                "subscriber" => 'BBC',
                "conditions" => [
                    "status" => 'new',
                ],
            ]
        );

    if ($response->successful()) {
        $clientInformation["meta"]["webhooks"]["order"] = $response->body();
        return $clientInformation;
    }
    return $clientInformation;
} catch (Exception $e) {
    // 可自行增加日志记录逻辑，方便后续排查问题
    return $clientInformation;
}

内容的提问来源于stack exchange，提问作者AlmoDev