跳到主要内容

角色权限无法保存

快速设置

打开 Superadmin → Permissions → Roles，在删除角色前检查已分配的账号。整个过程约需 3 分钟。

本指南帮助你解决角色保存问题、角色删除受阻问题，以及基于角色筛选账号时出现的问题。

快速参考​

你看到的现象发生原因处理方式
已勾选的权限重新打开后变为未勾选角色仍包含旧版点号键重新保存角色
分类计数看起来不正确旧版和当前键格式混用再次执行全选
更新角色后 Billing 访问失败权限键不匹配，导致检查被阻止确认冒号格式的键
角色无法分配角色包含已停用的权限移除已停用的权限
权限显示 Unrecognized permission当前权限目录中没有该权限的描述查看权限代码
Delete Role 已禁用角色仍分配有账号查看已分配的账号
账号列表显示混合的酒店或角色结果URL 中存在过期筛选条件清除所有活动筛选

重新保存角色​

  1. 前往 Superadmin → Permissions。

  2. 打开 Roles 标签页。

  3. 找到受影响的角色并点击 Edit。

  4. 确认已选择所需权限。

  5. 点击 Update Role。

  6. 重新打开该角色。

    ✓ 已选择的权限应保持勾选状态。

原因说明

AVA 现在使用 : 而不是 . 保存规范的权限键。

刷新分类选择​

  1. 在角色弹窗中打开受影响的权限分类。

  2. 点击 Deselect all。

  3. 点击 Select all。

  4. 点击 Update Role。

  5. 重新打开角色并检查计数。

    ✓ 分类计数应与已选择的行数一致。

验证 Billing 权限​

  1. 打开 Superadmin → Permissions → Roles。

  2. 编辑应有权访问 Billing 的角色。

  3. 确认已选择 admin:billing。

  4. 保存角色。

  5. 让用户刷新后重试 Settings → Billing。

    ✓ 角色拥有正确权限时，Billing 应能正常加载。

移除已停用的权限​

旧角色可能包含 AVA 已不再支持的权限键。 AVA 会在当前权限目录中隐藏这些键，并阻止新的分配操作。

  1. 打开 Superadmin → Permissions → Roles。

  2. 找到受影响的角色并点击 Edit。

  3. 检查已选择的权限。

  4. 移除已停用或过时的权限。

  5. 点击 Update Role。

  6. 重新打开角色，确认只保留当前权限。

    ✓ 你可以将清理后的角色分配给其他账号。

安全清理

获得授权的管理人员可以编辑、撤销、替换或删除过时的角色。 已停用的权限无法复制到新角色或新的分配中。

查看已分配的账号​

  1. 前往 Superadmin → Permissions → Roles。

  2. 找到要检查的角色。

  3. 点击 View assigned accounts。

  4. 确认打开的 Account Management 页面已应用角色筛选条件。

    ✓ 你应看到 Filter by Hotel、角色筛选标签以及筛选后的账号结果。

原因说明

AVA 现在会使用角色查询筛选条件打开 Account Management，从而准确显示分配了该角色的账号。

清除所有活动筛选​

  1. 打开 Superadmin → Account Management。

  2. 检查是否启用了酒店或角色筛选。

  3. 点击 Clear filters。

  4. 确认账号列表已刷新。

    ✓ 结果应在没有酒店或角色筛选条件的情况下重新加载。

解除账号分配后删除角色​

  1. 在 View assigned accounts 中记下使用该角色的所有用户。

  2. 将每位用户重新分配到其他角色。

  3. 返回 Superadmin → Permissions → Roles。

  4. 再次尝试 Delete Role。

    ✓ 所有账号解除分配后，删除操作应恢复可用。

如果删除仍然失败

如果 AVA 显示冲突消息，请先完成该消息要求的操作，然后重试。

故障排查​

权限复选框看起来未勾选​

你看到的现象： 某项权限应已启用，但显示为未勾选。

处理方式：

  1. 编辑该角色。
  2. 重新选择该权限。
  3. 使用 Update Role 保存。
  4. 重新打开角色，确认该权限仍处于选中状态。

分类计数不正确​

你看到的现象： 已选计数与勾选的行数不一致。

处理方式：

  1. 刷新页面。
  2. 重新打开角色弹窗。
  3. 对该分类使用 Select all。
  4. 保存并重新打开，确认计数保持稳定。

用户仍无法打开 Billing​

你看到的现象： 修改角色后仍无法使用 Billing。

处理方式：

  1. 确认角色中已选择 admin:billing。
  2. 确认该角色已分配给用户。
  3. 让用户退出后重新登录。

权限描述无法识别​

你看到的现象： 某项权限显示 Unrecognized permission，并附有可读的代码。

处理方式：

  1. 查看消息旁显示的权限代码。
  2. 如果该角色需要此访问权限，请保留该权限。
  3. 如果无法识别它授予的访问权限，请联系支持团队。

该消息是当前权限描述不可用时的安全回退提示。 这不表示权限失效或已被移除。

如果当前权限目录中没有该权限，请按照移除已停用的权限操作。

Delete Role 已禁用​

你看到的现象： Delete Role 按钮呈灰色，无法点击。

处理方式：

  1. 点击该角色的 View assigned accounts。
  2. 将列出的每位用户重新分配到其他角色。
  3. 返回角色列表并重试删除。

只有当前组织或酒店拥有、且未分配给任何账号的自定义角色可以删除。

Delete Role 显示冲突错误​

你看到的现象： 删除角色时收到具体的冲突错误。

处理方式：

  1. 阅读完整的冲突消息。
  2. 完成消息中指定的操作。
  3. 重试 Delete Role。

账号列表仍显示筛选结果​

你看到的现象： 更改角色或酒店后，账号结果仍被缩小范围。

处理方式：

  1. 在 Account Management 中点击 Clear filters。
  2. 确认酒店和角色筛选均已清除。
  3. 如果结果看起来仍未更新，刷新页面。

仍然无法解决？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 保存后权限仍被重置
  • ❌ 分类计数仍不一致
  • ❌ 已正确分配角色但 Billing 访问失败
  • ❌ 解除所有账号分配后仍无法删除角色
  • ❌ 完成所需操作后冲突错误仍然存在

建议一并提供：

  • 角色权限页面截图
  • 角色名称和受影响的权限键
  • 最近一次保存失败的时间
  • AVA 中显示的完整删除冲突消息