PayPal API不同机器运行表现不一致报INVALID_REQUEST如何解决？

问题根因 #

• 你的开发环境和同事环境的PHP配置不同：precision（浮点数显示精度）和serialize_precision（序列化/字符串转换时的浮点数精度）配置值不一致，你的环境该配置值过高，导致浮点数转字符串时输出了完整的二进制精度数值，出现40.979999999999997这类不符合PayPal接口要求的格式。
• 报错字段是billing_cycles/0/pricing_scheme/fixed_price/value，你修改的setup_fee的$amount并非报错字段，所以修改后没有生效。
• 手动拼接JSON字符串是触发问题的核心诱因：手动拼接时PHP会自动将浮点型数值转成字符串，触发精度溢出，同时也容易出现特殊字符转义、格式错误等其他问题。

解决方案 #

推荐方案（永久生效，无兼容性问题） #

放弃手动拼接JSON，统一使用PHP内置json_encode方法生成请求体，该方法会自动处理数值格式、特殊字符转义，避免格式错误：

1. 构造请求参数数组，所有金额字段统一处理为保留2位小数的字符串格式：

// 先处理billing_cycles里的金额字段，解决报错的字段精度问题
foreach ($billingCycles as &$cycle) {
    if (isset($cycle['pricing_scheme']['fixed_price']['value'])) {
        // 强制保留2位小数，转成字符串
        $cycle['pricing_scheme']['fixed_price']['value'] = number_format($cycle['pricing_scheme']['fixed_price']['value'], 2, '.', '');
    }
}
unset($cycle);

// 构造完整请求参数
$postData = [
    'product_id' => $this->productId,
    'name' => $name,
    'description' => $description,
    'billing_cycles' => $billingCycles,
    'payment_preferences' => [
        'auto_bill_outstanding' => true,
        'setup_fee' => [
            'value' => number_format($amount, 2, '.', ''),
            'currency_code' => 'EUR'
        ],
        'setup_fee_failure_action' => 'CONTINUE',
        'payment_failure_threshold' => 2
    ]
];

// 生成JSON，JSON_PRESERVE_ZERO_FRACTION参数确保整数金额也保留.00格式，符合PayPal接口要求
$data = json_encode($postData, JSON_PRESERVE_ZERO_FRACTION);

2. 替换原有手动拼接的$data字符串即可，其余curl请求逻辑无需修改。

临时兼容方案 #

如果暂时不想修改请求体构造逻辑，可以调整PHP配置和同事环境对齐，修改php.ini配置项：

precision = 14
serialize_precision = 14

修改后重启服务即可生效，该方案仅适配当前环境，换环境仍可能触发相同问题，不推荐长期使用。

内容的提问来源于stack exchange，提问作者Ahmet Eroğlu