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

# 排查指南详细说明

通用前置检查：

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

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

问题现象：
1. 主数据基线包没有正常部署
2. 启动过程报错或手动中止后，再启动不重新部署基线包
3. 后续使用主数据时无法正常配置模型
4. 模型配置页面提示“构建包不存在”
排查步骤：
1. 第一步：排除产品BUG
  - 操作：搜索关键词 基线包、构建包、初始化
  - 相关补丁：
    - MDM_7.3_UI_20251208_P1（修复子模型字典修改后反显失效，前置补丁需最新AFCenter UI）
    - MDM_7.3_ALL_20251215_P1（数据维护工作流增强）
  - 解决方案：若找到描述匹配的补丁，则申请并应用
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
  - 操作：搜索关键词 启动、服务、端口
  - 相关补丁：
    - MDM_7.3_SERVER_20260115_C1（修复数据库连接池断开问题）
    - MDM_7.3_SERVER_20260202_P1（JPA事务优化及数据库连接池断开问题）
  - 解决方案：若找到描述匹配的补丁，则申请并应用
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_20260115_C1（修复数据库连接池断开问题，数据库相关操作出现CommunicationsException异常）
    - MDM_7.3_SERVER_20260202_P1（JPA事务优化及数据库连接池断开问题）
  - 解决方案：若找到描述匹配的补丁，则申请并应用
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> <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）
  - 解决方案：若找到描述匹配的补丁，则申请并应用
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（数据维护工作流增强）
  - 解决方案：将AFCenter前端更新到最新版本
2. 第二步：根据问题现象排查
  - 现象：没有执行方法的权限
    - 问题原因：未为用户授权低开应用的开发权限
    - 排查项：当前用户是否已授权低开开发权限
    - 解决方案：
      - 在“低开中心”或“开发中心”中，点击设置图标
      - 在“应用设置”中，添加授权对象
      - 在弹窗中选择要授权的用户
      - 为用户授权“低开项目管理员”和“低开项目开发”权限
      - 授权完成后重新尝试配置模型
  - 现象：构建包不存在或导入失败
    - 排查项：基线包是否已正常部署
    - 排查项：导入的构建包文件是否完整
    - 解决方案：
      - 按场景一方法检查并导入基线包
      - 确保构建包文件未损坏