WordPress自定义主题多选项页修改时互相清空值问题排查

这是WordPress后台选项开发的典型常见问题，核心是选项注册、提交逻辑的冲突，具体原因按出现概率从高到低排序如下：

• 两个选项页注册的存储选项名重复
  调用register_setting()函数时，第二个参数为最终存入wp_options表的选项名，如果两个类用了同一个选项名，保存时新提交的配置会直接覆盖整个选项值，另一个页面的配置自然被清空。
• 选项组名混用
  即便你用了不同的存储选项名，如果两个页面调用settings_fields()时传入的是同一个选项组，或者表单提交的option_page参数值相同，WordPress会自动更新该选项组下绑定的所有存储选项，只要你当前提交的表单没有包含另一个选项的字段值，就会被默认置空。
• 保存钩子没有做页面校验
  如果你自定义了保存逻辑（不是用WordPress原生的设置提交机制），两个类都挂载了同一个后台提交钩子（比如admin_init、admin_post），且没有判断当前提交的是哪个页面的表单，会导致两个保存逻辑先后执行，没有对应字段的页面配置会被置空。
• 字段命名冲突
  如果你把两个页面的配置都存在同一个数组类型的选项里，但是字段的name属性没有加对应的数组前缀，提交时会互相覆盖键值，导致未提交的字段被清空。

• 优先核对两个类中register_setting的第二个参数，确保是完全独立的字符串，比如分别命名为theme_scroll_settings、theme_preloader_settings，不要使用通用命名。
• 检查每个设置页表单内的settings_fields()调用，传入的是各自页面专属的选项组名，不要混用。
• 自定义保存逻辑中增加校验：判断$_POST['option_page']是否和当前页面的选项组一致，再执行保存操作。
• 若使用同一数组存储所有配置，所有字段的name属性要加对应前缀，比如滚动设置字段写为scroll_settings[scroll_speed]，预加载器字段写为preloader_settings[enable]。

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