WordPress中acf-json内的Options Page无法加载如何解决？

这是ACF集成自定义主题/插件时的常见场景，可按以下优先级排查：

• 优先检查Options Page注册逻辑：ACF不会加载绑定了未注册Options Page的字段组，确认你在staging环境的功能代码中，已经提前注册了对应slug的Options Page，且注册代码的执行优先级早于ACF加载字段组的时机，建议放在after_setup_theme钩子下执行，优先级不低于10。
• 校验缺失字段组的JSON配置：打开/acf-json/group_60de1e5c.....json文件，检查两个核心配置：
  • 确认active属性值为true，若为falseACF会自动忽略该字段组
  • 检查location配置段中绑定的Options Page slug，和你注册Options Page时传入的slug完全一致，大小写、特殊符号均不能有差异
• 验证JSON文件读取状态：可以临时添加以下代码到主题functions.php中，进入后台后查看所有被ACF识别到的acf-json文件列表，确认目标字段组文件是否被正常读取：

add_action('admin_init', function () {
    if (!function_exists('acf_get_local_json_files')) return;
    $all_json_groups = acf_get_local_json_files();
    echo '<pre style="padding:2rem;background:#f0f0f0;z-index:999;position:relative;">';
    print_r(array_keys($all_json_groups));
    echo '</pre>';
});

若列表中存在对应group_60de1e5c的key，说明文件读取正常，问题出在字段组的加载匹配规则；若不存在，检查该文件的权限是否和其他5个正常加载的JSON文件一致，文件名有没有拼写错误。

• 排查缓存问题：少数情况ACF后台同步列表会存在缓存，可尝试清空WP缓存、重新进入ACF字段组后台页面，或通过WP CLI执行同步命令wp acf sync排查。

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