# 下拉选择组件相关问题排查指南
# 一、前置操作：补丁更新
在开始排查问题前，请务必完成以下补丁更新步骤，以排除已知问题的干扰：
- 前端： 优先安装最新的前端补丁
- 后端： 优先建议安装后端合集补丁，若无合集补丁通过以下链接检查是否存在相关补丁。若存在，请先安装对应补丁再进行后续问题排查
补丁参考链接：http://help.primeton.com/productcs/patches/
# 二、问题排查
# 2.1 联动后子级下拉只显示 Code/ID，不显示名称
现象描述
例如 A 和 B 两个字段，B 字段为字典项且值根据 A 字段变化。在编辑状态下修改 A 字段后，B 字段无法显示字典名称，仅显示 Key 值，需手动点击下拉框后才能正常显示。可能原因
动态赋值后未触发选项数据的重新加载。解决方案
在联动事件中手动刷新子级选项：this.Api.getElement('子字段名').setOptions(this.options);
# 2.2 表单编辑状态下拉框显示空白或仅显示 Code，保存后查看正常
现象描述
例如持久化实体字段使用下拉框控件且数据来源为自定义，发起流程时表单不显示；或单选组件（数据来源为数据字典）在列表中无法正常回显。可能原因
扩展对象（__xxxObject）未正确生成。解决方案
- 安装最新前端补丁并清理浏览器缓存。
- 检查数据实体源是否开启“持久化显示值”选项。
- 可使用响应式赋值：
this.$set(this.formData, "__xxObject", __xxObject);
# 2.3 切换英文环境后，下拉字典显示 null
现象描述
例如在 eos833 主页切换为英文模式后，下拉字典可选择但仅显示编号，且展示为null。核心原因
业务字典缺少对应的国际化翻译条目。解决方案
在业务字典中进行国际化配置。
# 2.4 下拉选择数据超过 200 条时，后续数据无法选择或默认值不回显
现象描述
下拉数据源为数据实体且数据量超过 200 条时，只能选择前 200 条数据，后续数据无法选择，设置为默认值也无法回显。核心原因
组件默认采用懒加载机制，仅加载前 200 条数据。解决方案
在组件的“扩展属性”中添加maxOptions属性，按需设置值。
# 2.5 下拉选择中指定值字段为 name 进行搜索时，页面卡死
现象描述
例如在视图自定义筛选条件中，选择下拉组件并指定值字段为name，保存预览后在下拉框中搜索导致页面卡死。核心原因（高危）
数据实体的“值字段”存在重复值，引发渲染死循环。解决方案
- 修改数据实体，保证值字段全局唯一（建议使用
id作为值字段）。 - 若无法保证唯一性，改用“弹窗选择”组件替代下拉组件。
- 修改数据实体，保证值字段全局唯一（建议使用
# 2.6 下拉框无法展开、控制台报错或过滤条件不生效
现象描述
下拉选择组件数据来源为数据实体，添加过滤条件后组件渲染失败；或过滤条件（如某字段不为null）不生效，重新打开页面后过滤条件变为“无”。核心原因
过滤语法错误，字符串值未加引号。解决方案
字符串值必须使用单引号包裹，示例：dept_name = '财务部'
# 2.7 复杂联动场景：省市区级联不生效
现象描述
省市区三级联动下拉无法正常加载或筛选。核心原因
父字典映射错误或字典层级未定义。解决方案
- 检查子组件的“父字典”属性是否指向父级绑定的字段名。
- 检查平台“业务字典”是否已正确配置父子层级关系。
# 2.8 移动端常见问题
| 问题现象 | 解决方案 |
|---|---|
| 下拉多选点击确认后，再次点开只显示一个值 | 安装最新前端 UI 补丁 |
| 下拉选择级联失效（PC 正常） | 安装最新前端 UI 补丁 |
| 下拉选择内容清空后，再次点开仍保留旧值 | 安装最新前端 UI 补丁 |