权限与账号问题 - 排查与解决手册

---

1. 用户不存在/ID 错误

现象：执行任务时报 User not found: 1061，或刷新调度引擎时报 NumberFormatException: For input string: "dam-user-1"。

解决步骤：

1. 检查用户 ID 是否为数字

   • 登录 AFCenter 数据库，执行：SELECT id, user_name FROM afc_user WHERE user_name = '问题用户';
   • 登录 Dolphin 数据库，执行：SELECT id, user_name FROM t_ds_user WHERE user_name = '问题用户';
   • 确认两个表中的 id 字段均为数字，且一致。

2. 若 ID 为字符串（如 dam-user-1）：

   • 建议将用户ID改为不和其他用户ID冲突的数字ID或新建用户（自动生成数字 ID），重新授权。

3. 若两个表 ID 不一致：

   • 备份后，手动更新 Dolphin 的 t_ds_user 表，将 ID 改为与 afc_user 一致：

     UPDATE t_ds_user SET id = 1061 WHERE user_name = 'dam-user-1';

4. 在项目配置中点击“刷新调度引擎”，强制同步用户。

---

2. 权限不足（无菜单权限）

现象：点击项目开发时报“当前用户未配置任何菜单权限”，或看不到某些菜单。

解决步骤：

1. 检查用户角色

   • 登录 AFCenter，进入“权限管理-用户管理”，找到对应用户。
   • 确认用户已分配“数据开发项目管理员”、“数据治理项目开发”等必要角色。

2. 检查业务对象权限

   • 进入“应用中心”，找到 DWS 应用。
   • 进入“业务对象管理”，检查以下业务对象是否已授权给该角色：
     • DWS_PROJECT_DEV（项目开发）
     • DWS_PROJECT_PRODUCTION（生产项目）
     • DWS_SCHEDULER（作业调度）
     • DWS_OPERATION（运维中心）
   • 若未授权，编辑角色，勾选所需菜单。

3. 若使用了数据租户，确保用户已添加到正确的租户中。

---

3. 登录异常：Session invalid or not logged in

现象：进入 IDE 或点击项目开发时，提示“Session invalid”或跳转到登录页。

解决步骤：

1. 清除浏览器缓存，重新登录。

2. 检查 AFCenter 与 DWS 的集成补丁

   • 若 AFCenter 刚升级到 8.3.1 以上版本，需申请 DWS 前端补丁 DWS7.0.2_UI_20241125_P1 并部署。

3. 检查 Nginx 配置，确保 /afc/api 等路由正确代理到 AFCenter 后端。

4. 调整会话超时时间（可选）：在 DWS server 的 application.properties 中增加：

   server.session.timeout=3600

---

4. 调度引擎刷新报错：NumberFormatException

现象：在项目配置中点击“刷新调度引擎”时，报 NumberFormatException: For input string: "dam-user-1"。

解决步骤：

1. 定位问题用户

   • 查看异常信息中的字符串（如 dam-user-1），找到对应用户。

2. 从项目成员中移除该用户

   • 进入项目配置-项目成员，删除该用户。

3. 若该用户必须使用，按第 1 条将其 ID 改为数字，然后重新添加到项目。

4. 再次点击“刷新调度引擎”，应正常执行。

---

5. 数据源租户问题：项目配置中选不到数据源

现象：在项目配置中添加数据源时，看不到已创建的数据源。

解决步骤：

1. 检查项目是否启用了数据租户

   • 进入项目配置-基本信息，查看“数据租户”字段是否有值。若有，表示启用了租户隔离。

2. 将数据源添加到租户

   • 进入“公共资源-数据租户”，找到项目使用的租户。
   • 点击“添加资源”，选择需要的数据源。
   • 保存后，返回项目配置-数据源配置，刷新页面。

3. 检查存算引擎环境

   • 确保数据源关联的存算引擎的环境标识（开发/生产）与项目一致。

---

6. 项目成员添加报错：handlePartyAuth

现象：在项目配置中添加成员时，报“没有执行方法的权限，方法名'handlePartyAuth'，可能需要授权功能码'afc-f-auth-role-party-bind'”。

解决步骤：

1. 使用管理员账号操作，或为当前用户授权。

2. 在 AFCenter 中授权功能码

   • 进入“权限管理-功能权限”，搜索功能码 afc-f-auth-role-party-bind。
   • 将该功能授权给当前用户角色。

3. 若为 AFCenter 8.3.2 版本，可申请补丁 PLATFORM_8.3.2_AFCENTER_UI_20241115_P1。

---

7. 用户同步问题：Dolphin 中用户未自动创建

现象：在 AFCenter 中新建用户后，Dolphin 的 t_ds_user 表中没有对应记录。

解决步骤：

1. 手动触发同步

   • 在项目配置中点击“刷新调度引擎”，DWS 会自动将项目成员同步到 Dolphin。

2. 若仍无记录，检查 Dolphin 数据库连接是否正常，以及 DWS server 日志中是否有同步失败信息。

3. 临时手动插入（仅作应急，不推荐）：

   INSERT INTO t_ds_user (id, user_name, user_password, user_type, tenant_id, create_time, update_time)
   VALUES (用户ID, '用户名', '加密密码', 'GENERAL_USER', 0, NOW(), NOW());

---

快速定位表

异常现象	章节
User not found: 1061	1
NumberFormatException: "dam-user-1"	1、4
当前用户未配置任何菜单权限	2
Session invalid	3
刷新调度引擎报错	4
项目配置选不到数据源	5
添加成员报错 handlePartyAuth	6
Dolphin 中没有新用户	7

---

预防与最佳实践

1. 用户 ID 规范化：所有用户 ID 必须为数字，避免使用字符串。
2. 角色权限标准化：建立标准角色模板，包含 DWS 所需业务对象。
3. 定期刷新同步：在项目配置中点击“刷新调度引擎”，确保用户同步。
4. 数据租户管理：使用数据租户时，及时将新数据源添加到租户。
5. 补丁更新：关注 AME+ 平台，及时打上权限相关补丁。

---

注：所有数据库操作前请备份。补丁请从 AME+ 平台申请。