OMS-ERP故障排除手册：常见问题诊断与解决方案
项目地址: https://gitcode.com/gh_mirrors/om/oms-erp OMS-ERP是一站式全渠道业务中台系统，集成订单管理、库存管理和财务管理等核心功能。本手册将帮助用户快速诊断并解决系统运行中可能遇到的常见问题，确保业务流程顺畅运行。
一、系统日志查看指南
系统日志是排查问题的重要依据，OMS-ERP前端错误日志处理逻辑位于front-end/src/utils/error-log.js。该文件配置了不同环境下的错误收集策略，默认在生产环境中启用详细错误记录。
1.1 前端错误日志
前端错误会自动记录到Vuex状态管理中的errorLog模块，可通过开发者工具查看store.state.errorLog获取错误详情。关键代码如下：
Vue.config.errorHandler = function(err, vm, info, a) {
Vue.nextTick(() => {
store.dispatch('errorLog/addErrorLog', {
err,
vm,
info,
url: window.location.href
});
console.error(err, info);
});
};
1.2 后端日志位置
后端微服务日志通常配置在各模块的application.yml文件中，常见日志路径包括：
- skyer-order模块：
skyer-order/src/main/resources/application.yml - skyer-stock模块：
skyer-stock/src/main/resources/application.yml
二、常见登录问题解决方案
2.1 登录页面无法加载
当登录页面无法正常显示时，首先检查前端资源加载情况。系统登录页面背景图位于front-end/src/assets/image/login-background.jpg，若该资源加载失败，可能导致页面布局异常。
OMS-ERP系统登录页面背景图，若无法显示可能是资源路径配置错误
解决方案：
- 检查网络请求，确认
login-background.jpg资源是否返回404错误 - 验证前端打包配置文件front-end/vue.config.js中的资源路径设置
- 清除浏览器缓存或使用无痕模式尝试登录
2.2 账号密码正确但登录失败
此问题通常与认证服务或权限配置有关，可按以下步骤排查：
- 检查浏览器控制台是否有401/403错误提示
- 验证front-end/src/api/commonApi/loginApi.js中的接口地址是否正确
- 确认用户角色权限配置是否正确，相关配置位于front-end/src/store/modules/permission.js
三、订单处理异常解决方案
3.1 订单提交超时
订单提交超时通常与网络连接或后端服务响应有关。OMS-ERP的订单服务模块(skyer-order)负责处理订单相关业务逻辑，若遇到超时问题：
解决方案：
- 检查订单服务是否正常运行：
ps -ef | grep skyer-order - 查看订单服务日志，确认是否有数据库连接异常
- 调整前端请求超时设置，相关代码位于front-end/src/utils/request.js
3.2 订单状态更新失败
当订单状态无法正常更新时，可能是状态流转规则配置问题。系统状态流转配置文件通常位于：
- skyer-order/src/main/resources/flow/order-flow.xml
解决方案：
- 检查订单状态机配置是否完整
- 验证相关数据库表
sord_order和sord_order_status_history是否存在异常数据 - 重启订单服务：
cd skyer-order && mvn spring-boot:run
四、库存管理常见问题
4.1 库存数据不一致
库存数据不一致是常见问题，可能由并发操作或同步机制异常导致。OMS-ERP库存模块(skyer-stock)提供了库存调整功能：
OMS-ERP库存共享架构图，展示多仓库库存数据同步机制
解决方案：
- 执行库存同步命令：
cd skyer-stock && mvn exec:java -Dexec.mainClass="org.skyer.stock.application.service.impl.StockSyncServiceImpl" - 检查库存调整记录：
select * from sstock_adjust_record where adjust_status = 'FAIL' - 运行库存一致性校验工具：
java -jar skyer-stock/target/skyer-stock-1.0.0.jar --check-stock
4.2 仓库无法关联商品
仓库与商品关联失败通常是基础数据配置问题，可检查：
- 商品分类配置：front-end/src/views/center-business/goods/classify/index.vue
- 仓库配置页面：front-end/src/views/center-business/channel/storage/index.vue
- 关联关系表
sstock_warehouse_goods是否存在约束冲突
五、系统部署与配置问题
5.1 服务启动失败
服务启动失败多与配置文件有关，OMS-ERP采用微服务架构，各模块独立部署。以网关服务(skyer-gateway)为例：
解决方案：
- 检查端口是否被占用：
netstat -tulpn | grep 8080 - 验证配置文件skyer-gateway/src/main/resources/application.yml中的数据库连接信息
- 查看启动日志：
tail -f logs/skyer-gateway/info.log
5.2 配置中心连接异常
OMS-ERP使用配置中心统一管理配置，若出现连接异常可参考以下步骤：
OMS-ERP配置中心界面，用于管理系统各项配置参数
解决方案：
- 检查配置中心服务状态：
systemctl status skyer-config - 验证配置中心地址是否正确，配置文件位于front-end/src/utils/constants.js
- 重启配置中心客户端：
kill -9 $(ps -ef | grep config-client | awk '{print $2}')
六、性能优化建议
6.1 系统响应缓慢
当系统响应缓慢时，可从以下方面进行优化：
-
数据库优化：
- 检查慢查询日志，位于
skyer-order/logs/slow-sql.log - 优化索引，特别是
sord_order表的order_no和create_time字段
- 检查慢查询日志，位于
-
缓存配置：
- 检查Redis缓存状态：
redis-cli info stats - 调整缓存策略，配置文件位于skyer-goods/src/main/resources/application.yml
- 检查Redis缓存状态：
-
前端优化：
- 启用资源压缩，配置位于front-end/vue.config.js
- 优化路由懒加载，参考front-end/src/router/index.js中的路由配置
七、技术支持与资源
若遇到本手册未覆盖的问题，可通过以下途径获取帮助：
- 系统内置帮助文档：登录系统后访问"帮助中心"
- 技术架构文档：参考项目根目录下的技术架构.png
- 社区支持：通过系统"消息中心"发送技术支持请求，相关代码位于front-end/src/views/center-setting/message/send/index.vue
OMS-ERP系统技术架构图，展示各模块间的关系和数据流向
通过以上方法，大多数常见问题都能得到快速解决。如问题持续存在，建议收集详细日志信息并联系技术支持团队。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
