WordPress用User Role Editor误重置角色后权限随机丢失，能否长期运行补权限php代码？

核心可行性结论 #

从WordPress内置的API设计逻辑来看，你写的这段代码完全可以长期在线上环境保持激活运行。
WordPress核心的WP_Role类自带的add_cap()方法做了幂等处理：只要目标角色已经持有对应的能力，调用这个方法不会重复修改数据库记录，也不会触发逻辑冲突，反复执行不会对站点功能造成直接破坏。你目前测试下来运行效果符合预期，也说明基础逻辑是通顺的，没有语法层面的问题。

长期运行的潜在风险与问题 #

• 基础防御缺失，容易造成后台白屏
  你现在的代码直接拿get_role('librarian')的返回值去调用方法，如果后续操作不当、或者某个插件出bug把librarian角色删了，get_role()会返回空值，这时候对空值调用add_cap()会直接触发PHP致命错误，导致整个后台无法访问。
• 运行存在不必要的额外开销
  admin_init这个钩子会在每一次后台页面加载时触发，不管是编辑文章、查看用户列表、还是打开后台仪表盘，都会执行一遍这段函数。哪怕librarian的权限完整无缺，当前的代码依然会逐次调用add_cap()——虽然方法本身不会重复写入数据库，但每一次调用都会触发角色权限表的查询读取，长期累积会给数据库带来无意义的负载。
• 会静默覆盖手动调整的权限配置
  后续如果你需要收紧librarian的权限（比如临时移除upload_files能力、调整书籍类操作的权限范围），这段代码会在每次后台加载时自动把缺失的能力补回来，相当于你手动做的权限调整会被悄悄改掉。如果忘了自己挂载了这段补丁，后续排查权限不生效的问题时会耗费大量精力。
• 会掩盖权限随机丢失的根本故障
  你目前的代码本质是“事后补漏”的临时补丁，并没有定位权限随机丢失的核心原因——比如是否有其他权限类插件会定期重置角色配置、站点数据库是否存在偶发写入故障、对象缓存配置是否有误。长期依赖这段补丁运行，会让根因问题被持续掩盖，一旦后续主题更新、站点迁移导致这段代码失效，权限丢失的问题会集中爆发。

优化后的稳定版本代码 #

你可以把当前的代码替换为带防御判断、带能力校验的版本，大幅降低运行风险和不必要的开销：

function restore_librarian_permissions() {
  // 校验librarian角色是否存在，不存在直接退出避免致命错误
  $librarian = get_role('librarian');
  if ( ! $librarian ) {
    return;
  }
  // 统一维护需要补全的能力列表
  $required_caps = [
    'upload_files',
    'edit_books',
    'publish_books',
    'edit_published_books',
    'delete_books',
    'delete_published_books'
  ];
  // 仅在能力缺失时执行补全，减少不必要的数据库操作
  foreach ( $required_caps as $cap ) {
    if ( ! $librarian->has_cap( $cap ) ) {
      $librarian->add_cap( $cap );
    }
  }
}
add_action('admin_init', 'restore_librarian_permissions');

优化后的代码既保留了自动补全权限的核心功能，也避免了角色不存在时的报错问题，同时把数据库操作降到最低——只有确实出现能力缺失的情况，才会触发写入动作。

如果打算长期保留这段补丁，建议在站点的运维备忘里记录清楚这段代码的作用，避免后续调整权限时出现认知偏差。

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