添加选项页至仪表盘菜单后，更新未收到API设置保存确认消息求助

云上老周

2026-5-19

排查API设置保存无确认消息的问题

你能成功把选项页加到仪表盘菜单已经迈出一大步啦！不过保存设置后没收到确认提示，大概率是漏掉了几个和WordPress设置API相关的关键环节，我给你梳理下常见的排查方向：

忘记调用settings_errors()函数
WordPress的默认设置体系里，保存成功/失败的提示消息是靠这个函数输出的。你需要在你的选项页渲染代码里，表单的上方或者合适的位置加上这行代码：
```
settings_errors();
```
它会自动读取保存操作时生成的状态消息并显示出来。
表单提交的action和设置组不匹配
确保你的设置表单是提交到options.php这个WordPress标准端点，并且正确关联了注册的设置组。表单的基本结构应该是这样的：
```
<form method="post" action="options.php">
    <?php settings_fields( 'your-custom-settings-group' ); ?>
    <?php do_settings_sections( 'your-settings-page-slug' ); ?>
    <?php submit_button(); ?>
</form>
```
如果用了自定义的action地址，WordPress的默认消息机制就没法触发了。
未正确注册设置项
你需要用register_setting()把你的API设置项绑定到对应的设置组，同时配合add_settings_section()和add_settings_field()来定义字段结构。如果跳过这些步骤，WordPress没法识别你的设置，自然不会生成保存确认消息。
自定义保存逻辑里没手动添加提示
要是你没用到WordPress的默认设置API，而是自己写了保存逻辑，那得手动添加admin notice。比如在保存成功后添加：
```
add_settings_error( 'api-settings-notices', 'api-saved', 'API设置已成功保存！', 'updated' );
```
然后在页面里调用settings_errors('api-settings-notices')来显示这条自定义消息。