同步/导入用户常见问题

版本

说明

本文汇总「同步用户」功能的常见报错与异常现象，帮助快速定位失败原因并解决问题。

以下情况不产生特定报错码，但会影响同步用户的正常操作。

次级管理员无法同步用户

次级管理员可见的按钮取决于当前系统的用户来源配置：

同步数据集字段不可选

问题描述：创建的服务器数据集可以正常预览，但在使用该数据集同步或导入用户时，没有字段可选。

原因分析：数据集的 SQL 执行失败。查看后台日志，可能出现 SQL ServerException：对象名' '无效 等报错。常见于存储过程类的服务器数据集，嵌套之后 SQL 执行异常。

解决方案：检查数据集的创建方式，确认 SQL 语句可以正常执行。

服务器数据集存在非法角色名称

问题描述：以下两种情况会触发此报错：

• 角色名称为非法角色名：superusers

• 用户名称与超级管理员重名

解决方案：修改角色名称或用户名称，避免使用非法角色名和与超级管理员重名的名称。

同步结果面板报错（用户 ID 校验）

配置 ID 列后，系统会进行 ID 校验以防止入库冲突。校验失败的数据会列在同步结果面板中。以下为各类用户 ID 相关报错。

ID 为空

问题描述：ID 为空

原因分析：勾选了 ID 列后，不允许出现 ID 为空但用户名不为空的情况。

解决方案：确保每条有用户名的记录都填写了对应的 ID 值。

和原有 ID 冲突

问题描述：和原有 ID 冲突

原因分析：勾选 ID 后更改了用户名，但 ID 不允许更改。例如，原本用户 Alice 的 ID 为 3，现在变动为 2，即会报 ID 冲突错误。

解决方案：保持用户的 ID 不变。如需更改用户名，ID 应保持原值。

ID 与其他对象重复

问题描述：ID 与其他对象重复

原因分析：多个用户名使用了同一个 ID。

解决方案：确保每个用户拥有唯一的 ID，不同用户不能共享同一 ID。

对应多个 ID

问题描述：对应多个 ID

原因分析：同一个用户名存在多个 ID。

解决方案：确保每个用户名只对应一个 ID，删除重复的 ID 记录。

报错码一览

遇到报错码时，可在下表中快速定位对应条目，再至详情查看原因分析和解决方案。

术语说明：

• 部门标记：构建树数据集时选择的原始标记字段。

• 父部门标记：构建树数据集时选择的父标记字段。

21300031-达到设定的中断值

问题描述：本次同步用户数量将减少 XX%（XX 个），达到设定的中断值 XX%。请检查数据源数据是否正常，或暂时关闭「异常数据中断同步」功能。

原因分析：

同步用户高度依赖数据源。若数据源出现问题（例如被恶意清空数据库表），会导致同步到系统中的用户被清空，操作无法逆转。因此 FineReport 提供「异常数据中断同步」功能。

管理员开启「异常数据中断同步」后，可设置用户数量减少达到 X% 时停止同步（X 为 1-100 的正整数）。例如，系统中原有 100 个同步用户，设置为 30%，即同步减少 30 个及以上用户时停止本次同步。

解决方案：

1）检查数据源数据是否正常，确认是否存在大量用户被删除的情况。

2）如确认数据源无误，可暂时关闭「异常数据中断同步」功能后重试。

21300050-部门对应多个ID

问题描述：报表对应多个ID

原因分析：同一个部门存在多个部门 ID。例如，帆软软件-报表有 a12 和 a15 两个部门 ID。

解决方案：确保每个部门只对应一个部门 ID，删除重复的 ID 记录。

21300051-部门ID与其他对象重复

问题描述：报表ID与其他对象重复

原因分析：不同部门使用了相同的部门 ID。例如，帆软软件-报表与帆软软件-决策平台使用了相同的部门 ID。

解决方案：确保每个部门拥有唯一的部门 ID，不同部门不能共享同一 ID。

21300052-部门ID与原有ID冲突

注意：2020-06-08 及之后的 JAR，该错误码将不再出现。

问题描述：决策平台和原有ID冲突

原因分析：部门 ID 发生改变，与系统中已存在的部门 ID 冲突。

解决方案：保持部门 ID 不变，不要修改已同步部门的 ID 值。

21300053-部门ID为空

问题描述：ID为空

原因分析：树数据集勾选部门 ID 后，如果某条记录的部门 ID 为空，则直接全局报错。

解决方案：确保每条部门记录都填写了部门 ID 值，不允许出现空值。

21300054-部门标记值与部门ID不一致

注意：2020-08-03 及之后的 JAR，该错误码将不再出现。

问题描述：部门标记值与部门ID不一致

原因分析：部门标记为纯数字（如 11、111）时，会直接作为 ID 项插入部门表。此时如果又勾选了其他列作为部门 ID，且部门标记值与勾选的部门 ID 不一致，则报错。

解决方案：当数据源的部门标记为纯数字时，建议在 SQL 语句中使用字符串拼接一个英文字母，使部门标记与部门 ID 保持一致。

21300055-部门原始标记相同

问题描述：原始标记相同

原因分析：树数据集下，多个部门使用了同一个部门标记。例如，DEC 交互和报表的 did 都为 a12。

解决方案：确保每个部门拥有唯一的部门标记值，不同部门不能共享同一 did。

21300056-部门有多个直接父部门

问题描述：报表有多个直接父部门

原因分析：一个部门有多个父部门标记。例如，报表的 pid 同时为 a1 和 a2。

解决方案：确保每个部门只有一个父部门标记。如需表示多层级关系，应通过逐级指向实现。

21300057-找不到对应父部门

问题描述：树构建失败，xxx找不到对应父部门

原因分析：父部门标记不为空，但找不到对应的部门。例如，决策平台的 pid 为 a3，但没有任何部门的 did 为 a3。

解决方案：确保每个父部门标记都能找到对应的部门记录，或将顶层机构的父部门标记设为空值。

注意：同步用户数据集时，若服务器数据集为 树数据集，顶层机构的父机构应为空值。

21300058-部门有多个原始标记

问题描述：报表有多个原始标记

原因分析：部门名相同且父部门标记相同（说明是同一个部门），但部门标记不同。例如，报表的 did 有两个值 a13 和 a12。

解决方案：确保同一个部门只使用一个部门标记值。

21300059-父子结构死循环

问题描述：决策平台，帆软软件，DEC研发构成父子结构死循环

原因分析：部门之间的父子标记构成了环形引用。例如，部门a111 的父标记指向部门a11，部门a11 的父标记指向部门a1，部门a1 的父标记又指向部门a111，形成闭环。

解决方案：检查并消除父子标记之间的环形引用，确保树结构为单向层级关系。

21300063-名称与其他来源对象重复

问题描述：名称与其他来源对象重复

原因分析：导入的树数据集中存在与已同步部门重复的数据。例如，先同步了树数据集 A，再导入同一树数据集 A 时会出现此报错。

解决方案：避免重复导入已同步的树数据集。如需更新，应使用同步而非导入。

21300064-ID与其他来源对象重复

问题描述：ID与其他来源对象重复

原因分析：首次同步树数据集时选择「保留权限更新」，数据源中某同步部门与平台内置部门的 ID 相同但名称不同，同步后产生 ID 冲突。

解决方案：确保同步数据集中的部门 ID 不与平台内置部门的 ID 重复。

21300074-空指针异常

问题描述：出现空指针异常，请检查外置库/服务器数据集是否存在 null/空串，或数据库无法区分空字符与 NULL 数据

原因分析：外置库或服务器数据集中存在脏数据（null 或空串），或数据库无法区分空字符与 NULL。

解决方案：检查外置库和服务器数据集，排查并清理 null 或空串数据。

21300075-软删除表冲突

问题描述：请检查 fine_soft_data（或 FINE_SOFT_DATA）表，必要时清空后重试

原因分析：软删除表存在冲突数据。

解决方案：清空软删除表后重试同步。

21300076-数据集列下标越界

问题描述：数据集列下标越界，请检查字段-列映射配置

原因分析：同步配置的列映射与当前服务器数据集返回的实际列数不一致。

解决方案：检查同步设置中的「字段-列映射」配置，确保与数据集实际列数一致。

21300081-数据库唯一键冲突

问题描述：数据库唯一键冲突，请检查数据库大小写敏感性

原因分析：外置库存在唯一键冲突，常见于数据库大小写敏感性问题。

解决方案：检查数据库的大小写敏感性配置，确保数据不因大小写差异产生唯一键冲突。

21300084-批处理配置异常

问题描述：批处理配置异常，请检查外置库连接 URL 是否开启 batch 参数

原因分析：外置库的批处理配置存在问题。

解决方案：检查外置库连接 URL，确认是否已开启 batch 参数。

21300085-服务器数据集为空

问题描述：服务器数据集为空，本次同步终止；如需清空同步用户数据，请手动清空

原因分析：数据集为空，但平台中存在同步数据。

解决方案：

1）确认服务器数据集的状态是否正常。

2）如需清空同步数据，请手动清空，不可通过空数据集同步来清除。

21300088-存在重复值

问题描述：当前存在重复值：xxx，请检查数据集中的重复数据或进行脏数据和软删除表检测

原因分析：数据集或软删除表中存在重复字段数据。

解决方案：

1）检查原始数据集中的重复数据。

2）进行脏数据和软删除表检测。

21300109-外接数据库插件未注册

问题描述：失败原因：21300109 - xxx外接数据库插件未注册，请联系销售购买

信创版本工程导入用户失败。

原因分析：工程使用了信创版本外接 finedb 数据库，该类型数据库的功能点授权已过期，影响了导入用户功能。

解决方案：联系帆软销售，续购或增购该类型数据库的使用授权。

21307213-非法节点

问题描述：失败原因：21307213-非法节点

安装并使用「同步LDAP域用户」插件后同步用户失败，提示非法节点。

原因分析：

LDAP 服务器下的数据存在用户数据节点非叶子节点的情况，其下还存在用户、部门或角色数据节点。

同步时，用户属性、部门属性和角色属性会选择相同的内容，导致数据结构冲突。

解决方案：

方案一：仅同步用户，不同步部门和角色。

方案二：调整 LDAP 服务器中的数据存储结构，确保用户节点为叶子节点。

21300998-同步失败

问题描述：21300998-同步失败

原因分析：此类报错未命中已知分类，需要进一步分析。

解决方案：结合报错信息查看后台日志，获取详细堆栈信息进行分析。