先确认是不是客商主数据本身未生效
客商加载失败的首要判断点不是系统卡顿，而是主数据生命周期状态。NC中客商档案需同时满足已启用、未停用、所属组织已分配、业务范围已勾选四个条件才可在单据界面调用。若在【基础资料】→【客商管理】中查看该客商状态为‘未启用’或‘已停用’，则所有业务单据（采购订单、应付单、付款申请等）均无法加载该客商。
注意：NC 6.5及以上版本支持‘组织隔离’模式，即使客商已启用，若当前登录用户所属组织未被授权访问该客商所在组织，则仍显示为空。请先在【系统管理】→【组织权限】中核对组织可见性设置。
点击客商选择按钮无响应？优先检查前端加载环境
现象表现为：单据页面点击‘客商名称’右侧放大镜图标后弹窗空白、进度条卡死、或直接报错‘无法加载参照数据’。此类问题与服务端主数据无关，属于客户端运行环境异常。
- 清除IE/Edge浏览器缓存（NC默认兼容模式依赖本地临时文件）：按
Ctrl+Shift+Del全清，重启浏览器再试； - 禁用所有第三方浏览器插件（尤其广告拦截、密码管理类）；
- 切换至NC官方推荐的IE11兼容模式（非Edge内核），或使用NC Web端专用Chrome插件（需IT统一部署）；
- 检查本地Java运行时版本是否为NC要求的JRE 1.6–1.8（过高或过低均导致Applet加载失败）。
验证方式：直接访问NC Web服务健康地址
在浏览器地址栏输入http://[服务器IP]:8080/ncweb/health，若返回{"status":"UP"}说明服务正常；若超时或404，则问题在应用服务器或中间件层，需联系运维重启Web容器。
高频原因拆解：从服务端到数据库的4层断点
客商加载失败本质是‘参照数据源查询链路中断’。以下按调用顺序逐层定位：
1. 应用服务层：NC中间件连接池耗尽
现象：多人同时操作时偶发加载失败，重启浏览器无效，但重启NC应用服务后恢复。原因为数据库连接池满（默认maxActive=20），大量客商查询请求堆积。处理动作：修改ncserver.xml中，并监控nclog/server.log中是否有Connection wait timeout报错。
2. 数据库层：客商视图索引失效或统计信息陈旧
NC客商参照实际调用v_bd_psndoc视图（含客商+人员复合数据）。若DBA近期执行过表结构变更或大批量导入，可能导致视图底层索引失效。执行SQL校验：SELECT COUNT(*) FROM v_bd_psndoc WHERE pk_psndoc IS NOT NULL AND dr = 0; 若结果远小于实际客商数（如总客10000，查询仅返回200），需重建视图索引并更新统计信息。
3. 权限控制层：字段级数据权限误配
即使用户有客商管理权限，若在【数据权限】中为‘客商档案’对象设置了‘按部门过滤’，而当前登录用户无对应部门归属，则查询结果为空。检查路径：系统管理 → 数据权限 → 查看当前角色对‘客商档案’的数据权限规则，重点核对‘过滤条件’是否包含pk_dept IS NULL等强制约束。
4. 主数据同步层：多组织架构下客商未分发
集团型客户启用NC多组织后，客商需手动执行‘主数据分发’任务（路径：基础设置 → 主数据管理 → 主数据分发）。若新添加客商未执行分发，仅总部组织可见，分子公司组织单据中无法加载。分发日志需确认状态为‘成功’且目标组织列无红色叉号。
正确加载客商的3个前置动作
避免反复排查，建议在新增客商或上线前固化以下操作：
- 新增客商后，立即进入【客商档案】→【更多】→【启用】，并勾选‘启用日期’为当日；
- 在【组织权限】中为该客商所属组织分配‘客商档案’对象的‘查看’和‘引用’权限；
- 执行一次‘主数据分发’，目标组织至少包含当前用户所在组织及常用业务组织。
长期方案：什么场景应考虑升级到畅捷通产品
若企业频繁遭遇NC客商加载异常，且伴随以下特征，建议评估平滑迁移路径：
- 中小制造/商贸企业：客商数量＜5000、单据类型集中（采购/销售/收款/付款）、对审批流深度定制需求低 → 可优先评估用友畅捷通好生意，其客商模块采用云原生架构，加载响应＜1秒，支持微信扫码快速建档、手机端实时同步；
- 业财强协同场景：需实现‘销售合同→发货单→开票→应收→回款’全链路客商穿透，且财务需按客商维度自动归集毛利、账龄、信用额度 → 推荐用友畅捷通好业财，内置客商信用中心与业财一体主数据引擎，规避NC多系统数据割裂问题；
- 纯财务核算升级：若仅需解决凭证中客商辅助核算项加载慢、报表取数不准问题，无需进销存模块 → 用友畅捷通好会计提供轻量级客商管理+智能凭证生成，适配中小企业快速上云。
紧急回退方案：当加载失败影响当日开单
若问题发生在业务高峰期且无法即时修复，启用以下合规回退路径：
- 使用NC离线模板：导出标准客商Excel模板（含pk_psndoc、code、name、taxnum字段），线下填写后通过【数据导入】→【客商档案】批量导入（需管理员权限）；
- 临时启用手工录入：在单据界面取消‘客商必选’校验（路径：
单据配置 → 字段属性 → 客商名称 → 取消‘必填’勾选），允许输入客商简称+税号后暂存，待系统恢复后再补录完整档案； - 调用历史客商快照：在【系统工具】→【历史数据查询】中搜索最近7天有效客商记录，复制代码粘贴至单据字段，规避实时加载依赖。