无头WordPress中registerUser的ACF自定义字段未显示于GraphQL输入

问题概述 #

• 已为所有WP用户角色添加ACF自定义字段组，但registerUser GraphQL突变的输入参数里找不到这些字段，仅能在突变返回的user节点中看到对应字段组
• GraphQL Schema未自动更新，仍显示已删除的自定义文章类型（CPTs）

一、修复ACF用户字段在registerUser突变中无法作为输入的问题 #

1. 检查ACF字段组的GraphQL配置
   • 进入ACF字段组编辑页，逐个确认字段的「Show in GraphQL」已勾选，且「GraphQL Field Name」设置无误
   • 在WPGraphQL for ACF的设置面板中，确保该用户字段组的突变权限包含createUser（对应registerUser突变的操作权限）
2. 手动注册突变输入字段（自动同步失效时用）
   将以下代码添加到主题functions.php或自定义插件中，替换your_acf_field_slug为实际的ACF字段别名，字段类型匹配ACF设置（比如String/Int/Boolean）：

   // 给RegisterUserInput添加ACF字段
   add_action( 'graphql_register_types', function() {
       register_graphql_input_field( 'RegisterUserInput', 'your_acf_field_slug', [
           'type' => 'String',
           'description' => '自定义用户字段的描述',
       ] );
   } );
   
   // 注册用户时保存ACF字段值
   add_action( 'graphql_user_register', function( $user_id, $input ) {
       if ( isset( $input['your_acf_field_slug'] ) ) {
           update_field( 'your_acf_field_slug', $input['your_acf_field_slug'], 'user_' . $user_id );
       }
   }, 10, 2 );
   

3. 确认字段组条件规则
   再次检查ACF字段组的条件设置为User Role == All，无其他冲突条件限制字段组应用到用户对象。

二、修复GraphQL Schema未更新的问题 #

1. 清除WPGraphQL缓存
   • 进入WP后台「GraphQL」→「Settings」页面，找到「Schema Cache」选项，点击「Clear Schema Cache」按钮
   • 若找不到按钮，可临时添加以下代码执行缓存清除，完成后删除代码：

     add_action( 'init', function() {
         do_action( 'graphql_clear_schema_cache' );
     } );
     

2. 清理已删除CPTs的残留设置
   • 确认删除CPTs时已移除主题/插件中对应的register_post_type注册代码
   • 备份数据库后，检查wp_post_types表，删除已删除CPTs的残留记录
3. 重置相关插件
   依次禁用WP-GraphQL、WPGraphQL for ACF插件，再重新启用，触发Schema重新生成

三、验证效果 #

• 刷新GraphQL IDE，重新加载Schema，检查registerUser突变的输入参数是否出现目标ACF字段
• 执行registerUser突变并传入ACF字段值，验证字段是否成功保存到用户对象
• 查询用户数据，确认ACF字段值已正确存储并返回

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