
ACF 的 update_field() 函数更新用户字段时,必须将用户 ID 显式标识为 'user_' . $user_id,否则字段值不会写入数据库,导致看似“无效果”的常见问题。
acf 的 `update_field()` 函数更新用户字段时,必须将用户 id 显式标识为 `'user_' . $user_id`,否则字段值不会写入数据库,导致看似“无效果”的常见问题。
在 Advanced Custom Fields(ACF)中,update_field() 是一个对象感知型函数——它不会自动推断数据所属对象类型。即使你传入的是 $user_id(如 123),ACF 仍会默认将其视为 post ID,从而尝试向 wp_posts 表关联的字段表(如 wp_postmeta)写入数据,而非用户专属的 wp_usermeta 表。这正是你代码中 update_field('user-dir', $userdir, $user_id) 无效的根本原因。
✅ 正确做法是:显式指定对象前缀。ACF 官方约定如下:
- 用户字段 → 使用
'user_' . $user_id(例如'user_456') - 文章字段 → 使用
$post_id(整数或字符串均可) - 选项页字段 → 使用
'option' - 其他(如分类、评论等)需对应特定前缀
因此,你的原始代码应修正为:
function create_user_dir($user_id) {
$upload_dir = wp_upload_dir();
wp_mkdir_p($upload_dir['basedir'] . '/' . $user_id);
$userdir = 'bla bla bla';
// ✅ 关键修复:为用户对象添加 'user_' 前缀
update_field('user-dir', $userdir, 'user_' . $user_id);
}
add_action('user_register', 'create_user_dir');
⚠️ 注意事项:
- 确保字段名
'user-dir'在 ACF 字段组中完全匹配(包括大小写与连字符),推荐在后台复制字段标签旁的「Field Name」值; - 若该字段位于「User」位置规则下(即作用域为 Users),且已启用「Save to User Meta」(ACF Pro 默认行为),则无需额外配置;
- 建议添加错误检查以提升健壮性(可选):
if (false === update_field('user-dir', $userdir, 'user_' . $user_id)) {
error_log("ACF update_field failed for user {$user_id}");
}
? 小贴士:调试时可配合 get_field('user-dir', 'user_' . $user_id) 验证值是否成功写入;也可直接查询数据库确认 wp_usermeta 表中 _user-dir(注意前导下划线)的 meta_key 是否存在对应记录。
遵循此规范后,用户注册时目录创建与 ACF 字段更新将同步生效,彻底解决“字段不更新”的问题。










