主数据环境与部署问题排查指南

排查指南详细说明

通用前置检查：

• 确认版本：MDM 7.3.0
• 查看日志：通过服务启动日志、logs/eos-trace.log等获取详细错误信息
• 检查配置文件：config/application-mdm.properties、config/MDM/config/user-config.xml等关键配置
• 查阅补丁列表：主数据7.3补丁列表

---

场景一：安装/初始化异常

• 问题现象：

  1. 主数据基线包没有正常部署
  2. 启动过程报错或手动中止后，再启动不重新部署基线包
  3. 后续使用主数据时无法正常配置模型
  4. 模型配置页面提示“构建包不存在”

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：在补丁列表中搜索关键词 基线包、构建包、初始化
     • 相关补丁示例：
       • MDM_7.3_UI_20251208_P1（修复子模型字典修改后反显失效，前置补丁需最新AFCenter UI）
       • MDM_7.3_ALL_20251215_P1（数据维护工作流增强）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：基线包未正常部署

       • 排查项：访问“低开中心/开发中心” -> “主数据”页面，在IDE中检查是否有“主数据”、“主数据开发”构建包
       • 排查项：启动过程是否被手动中止或报错退出
       • 解决方案：
         • 如无构建包，手动导入基线包
         • 套件版路径：Primeton_MDM_7.3.0_Standalone/server/mdm/baseline/deploy/MDM_7.3.0_baseline_data.zip
         • 微服务版路径：Primeton_MDM_7.3.0_MicroApp/Primeton_MDM_7.3.0_Server/baseline/deploy/MDM_7.3.0_baseline_data.zip
         • 在IDE中点击“新增构建包” -> “导入构建包”，选择对应zip文件导入

     • 现象：模型配置提示“构建包[2801]不存在”

       • 排查项：AFCenter前端版本是否过旧
       • 解决方案：将AFCenter前端更新到最新版本，重新登录后再次配置模型

---

场景二：服务启动异常

• 问题现象：

  1. 服务启动失败，无明确错误信息
  2. 启动后部分功能不可用
  3. 端口被占用导致启动失败
  4. 配置文件加载失败

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 启动、服务、端口
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：服务启动失败

       • 排查项：查看启动日志中的具体错误信息
       • 排查项：检查配置文件格式是否正确（如application-mdm.properties）
       • 排查项：确认所需端口是否被占用
       • 解决方案：
         • 根据日志错误信息调整配置
         • 修改冲突的端口配置
         • 确保配置文件语法正确

     • 现象：启动后功能不可用

       • 排查项：检查是否所有服务模块都成功启动
       • 排查项：查看localhost.log和mdm.log中的警告或错误
       • 解决方案：根据日志定位具体模块问题

---

场景三：数据库连接异常

• 问题现象：

  1. “No operations allowed after connection closed”错误
  2. 数据库相关操作出现CommunicationsException异常
  3. 页面功能使用时断时续
  4. 连接池溢出或连接泄露

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 连接池、connection closed、CommunicationsException
     • 相关补丁示例：
       • MDM_7.3_SERVER_20260202_P1（JPA事务优化及数据库连接池断开问题）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：从C3P0连接池获取了不可用连接
       • 问题原因：C3P0数据源配置不合理，连接池中的失效连接未被及时清理。例如MySQL默认允许连接最大存活时长8小时，超时后服务端强制关闭连接
       • 排查项：检查config/MDM/config/user-config.xml中C3P0相关配置
       • 解决方案：优化C3P0配置参数

         <group name="default">
             <configValue key="C3p0-PoolSize">10</configValue>
             <configValue key="C3p0-MinPoolSize">5</configValue>
             <configValue key="C3p0-MaxPoolSize">50</configValue>
             <configValue key="C3p0-NumHelperThreads">5</configValue>
             <configValue key="C3p0.maxConnectionAge">25200</configValue><!-- 秒，需小于MySQL的wait_timeout -->
             <configValue key="C3p0.preferredTestQuery">SELECT 1</configValue>
             <configValue key="Retry-Connect-Count">-1</configValue>
         </group>

       • 关键参数说明：
         • C3p0.maxConnectionAge：设置连接最大存活时间，需小于数据库的wait_timeout
         • C3p0.preferredTestQuery：连接有效性校验SQL
         • C3p0.NumHelperThreads：连接池辅助线程数，建议取值范围3~CPU核心数*2

---

场景四：补丁部署异常

• 问题现象：

  1. 补丁部署后功能未修复
  2. 补丁加载失败或未生效
  3. 多个补丁同时部署导致冲突
  4. 补丁覆盖问题

• 排查步骤：

  1. 第一步：检查补丁命名规范

     • 规范说明：补丁使用时在jar包原名称前加数字序号，第几个部署的就加几个0，确保该jar优先加载
     • 示例：当前补丁是lib目录下打的第2个补丁，则jar名称可修改为：00mdm-core-7.3.0-patch-xxx.jar
     • 注意事项：补丁失效和补丁覆盖问题参考内部知识库文档

  2. 第二步：根据问题现象排查

     • 现象：补丁未生效

       • 排查项：补丁命名是否符合规范
       • 排查项：补丁是否放置在正确的目录（如lib目录）
       • 排查项：补丁版本是否与当前MDM版本兼容
       • 解决方案：
         • 按规范重命名补丁文件
         • 确保补丁放置位置正确
         • 重启服务使补丁加载

     • 现象：多个补丁冲突

       • 排查项：补丁之间是否有依赖关系（如前置补丁要求）
       • 排查项：补丁加载顺序是否正确（序号越小越优先加载）
       • 解决方案：
         • 检查补丁备注中的前置补丁要求
         • 调整补丁命名序号确保正确加载顺序

---

场景五：Nginx/代理配置异常

• 问题现象：

  1. 访问管理门户或业务门户时404
  2. 静态资源无法加载
  3. API请求超时或转发错误
  4. 附件预览或下载失败

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 nginx、代理、404、转发
     • 相关补丁示例：
       • MDM_7.3_UI_20251215_P1（优化工作台我的流程、问题数据统计跳转，解决404错误）
       • MDM_7.3_UI_20260209_P1（解决工作台我的流程、问题数据点击404）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：访问门户404

       • 排查项：Nginx转发配置是否正确
       • 排查项：proxy_pass指向的后端服务地址是否正确
       • 排查项：静态资源路径是否正确映射
       • 解决方案：
         • 添加正确的Nginx转发配置

         location /api/afc {
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
             proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
             proxy_set_header X-EOS-SourceSysKey dc6baaed30e541d78bb91274803d9432;
             proxy_pass http://AFCenter后端IP:端口;
         }
         
         location / {
             proxy_pass http://MDM后端IP:端口;
             proxy_set_header Host $host;
             proxy_set_header X-Real-IP $remote_addr;
         }

     • 现象：附件预览/下载失败

       • 排查项：Nginx是否配置了正确的MIME类型
       • 排查项：proxy_max_temp_file_size等参数是否限制了大文件下载
       • 解决方案：
         • 添加MIME类型配置：include mime.types;
         • 调整代理缓冲区大小：proxy_buffers 8 16k;

---

场景六：权限/构建包异常

• 问题现象：

  1. 配置模型时提示“没有执行方法的权限”
  2. 低开中心无法正常使用
  3. 构建包导入失败
  4. 用户无法进入开发中心

• 排查步骤：

  1. 第一步：排除产品BUG

     • 操作：搜索关键词 权限、构建包、低开
     • 相关补丁示例：
       • MDM_7.3_UI_20251208_P1（需最新AFCenter UI补丁）
       • MDM_7.3_ALL_20251215_P1（数据维护工作流增强）
     • 解决方案：
       • 1.优先使用产品最新补丁合集，见补丁列表中补丁合集列表
       • 2.若找到描述匹配的补丁，则申请并应用

  2. 第二步：根据问题现象排查

     • 现象：没有执行方法的权限

       • 问题原因：未为用户授权低开应用的开发权限
       • 排查项：当前用户是否已授权低开开发权限
       • 解决方案：
         • 在“低开中心”或“开发中心”中，点击设置图标
         • 在“应用设置”中，添加授权对象
         • 在弹窗中选择要授权的用户
         • 为用户授权“低开项目管理员”和“低开项目开发”权限
         • 授权完成后重新尝试配置模型

     • 现象：构建包不存在或导入失败

       • 排查项：基线包是否已正常部署
       • 排查项：导入的构建包文件是否完整
       • 解决方案：
         • 按场景一方法检查并导入基线包
         • 确保构建包文件未损坏