使用WooCommerce REST API更新ACF字段失败求助

核心问题排查与修复步骤 #

1. 启用ACF的REST API支持 #

• 若使用ACF免费版，需安装并激活ACF to REST API插件；ACF Pro版本可直接在字段组编辑页面，勾选「显示在REST API中」选项（每个需要更新的字段组都要开启）。
• 确保代码中使用的ACF字段键名与后台设置的完全一致（注意是字段的键名，不是显示名称）。

2. 修正请求方式与数据格式 #

• 更新产品需使用PUT请求（POST用于创建新产品），请求URL必须包含目标产品ID（示例：https://your-domain.com/wp-json/wc/v3/products/123）。
• WooCommerce REST API默认接收JSON格式数据，不能用http_build_query生成表单编码数据，需将数组转为JSON字符串，并设置对应的请求头。

3. 校验请求头与认证信息 #

• 请求头中必须添加Content-Type: application/json，否则API无法正确解析ACF字段数据。
• 确保$ckey和$csecret是具有产品编辑权限的有效API密钥。

修改后的完整代码 #

// 构造包含ACF字段的数据
$data['acf'] = [
    'acf_field1_name' => $acf_field1_value,
    'acf_field2_name' => $acf_field2_value,
    'acf_field3_name' => $acf_field3_value,
];

$curl = curl_init();
// 替换为你的产品更新端点，需包含产品ID
curl_setopt($curl, CURLOPT_URL, $url);
// 更新操作使用PUT请求
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_TIMEOUT, 30);

// 设置请求头，必须包含Content-Type
$headers = [
    'Content-Type: application/json',
    // 若有其他自定义头可在此添加
];
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

// 将数据转为JSON格式
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($data));

// 调试模式：生产环境建议删除以下两行
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

// API认证
curl_setopt($curl, CURLOPT_USERPWD, "$ckey:$csecret");

$resp = curl_exec($curl);
$status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE); 
curl_close($curl);

// 调试用：打印状态码与响应信息，方便排查问题
// echo "状态码: $status_code<br>";
// echo "响应内容: $resp";

额外排查建议 #

• 打印$status_code和$resp，根据返回的错误信息（如400参数错误、403权限不足）精准定位问题。
• 用Postman等工具直接测试API端点，确认ACF字段能被正常更新，排除代码逻辑外的配置问题。

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