跳到主要内容

故障排除指南

概述​

本指南提供几何成本估算软件常见问题的诊断和解决方案。如果您遇到的问题未在此指南中列出，请联系几何成本估算软件技术支持部门。

系统启动问题​

应用程序无法启动​

症状​

  • 双击应用程序图标无响应
  • 启动画面显示后立即关闭
  • 显示错误消息

可能原因​

  1. Java环境问题
  2. 内存不足
  3. 配置文件损坏
  4. 权限问题

解决方案​

检查Java环境

# 检查Java版本
java -version

# 检查JAVA_HOME环境变量
echo $JAVA_HOME

检查内存设置

# 检查系统可用内存
free -h

# 检查Java堆内存设置
java -Xms1024m -Xmx2048m -jar apriori.jar

检查配置文件

# 备份并重新创建配置文件
cp application.properties application.properties.backup
cp application.properties.template application.properties

检查权限

# 检查文件权限
ls -la apriori.jar

# 修改权限
chmod +x apriori.jar

数据库连接失败​

症状​

  • 启动时显示数据库连接错误
  • 无法访问数据
  • 连接超时

可能原因​

  1. 数据库服务未启动
  2. 连接参数错误
  3. 网络连接问题
  4. 数据库权限问题

解决方案​

检查数据库服务

# MySQL
sudo systemctl status mysql

# PostgreSQL
sudo systemctl status postgresql

# Oracle
sudo systemctl status oracle

检查连接参数

# 检查数据库配置文件
database.url=jdbc:mysql://localhost:3306/apriori
database.username=apriori_user
database.password=apriori_password

测试数据库连接

# MySQL
mysql -h localhost -u apriori_user -p apriori

# PostgreSQL
psql -h localhost -U apriori_user -d apriori

用户访问问题​

用户无法登录​

症状​

  • 输入正确凭据后仍无法登录
  • 显示"用户名或密码错误"
  • 账户被锁定

可能原因​

  1. 密码过期
  2. 账户被禁用
  3. LDAP连接问题
  4. 权限配置错误

解决方案​

重置用户密码

  1. 以管理员身份登录
  2. 打开系统管理员
  3. 选择用户管理
  4. 重置用户密码

检查账户状态

  1. 检查用户账户是否启用
  2. 检查用户是否属于有效组
  3. 检查用户权限设置

检查LDAP配置

# 检查LDAP配置
ldap.server.url=ldap://ldap.company.com:389
ldap.base.dn=dc=company,dc=com
ldap.bind.dn=cn=admin,dc=company,dc=com

权限不足​

症状​

  • 无法访问某些功能
  • 显示"权限不足"错误
  • 某些菜单项不可见

可能原因​

  1. 用户组配置错误
  2. 权限设置不正确
  3. 访问控制规则问题

解决方案​

检查用户组

  1. 确认用户属于正确的组
  2. 检查组的权限设置
  3. 验证访问控制规则

检查权限配置

  1. 查看权限矩阵
  2. 确认资源访问权限
  3. 检查规则表达式

性能问题​

系统响应缓慢​

症状​

  • 操作响应时间长
  • 界面卡顿
  • 内存使用率高

可能原因​

  1. 内存不足
  2. CPU使用率过高
  3. 数据库性能问题
  4. 网络延迟

解决方案​

检查系统资源

# 检查内存使用
free -h

# 检查CPU使用
top

# 检查磁盘使用
df -h

优化内存配置

# 调整堆内存设置
-Xms2048m
-Xmx4096m
-Xmn1024m

检查数据库性能

-- 检查慢查询
SHOW PROCESSLIST;

-- 检查索引使用
EXPLAIN SELECT * FROM components WHERE id = 1;

内存不足错误​

症状​

  • 显示OutOfMemoryError
  • 系统崩溃
  • 性能急剧下降

解决方案​

增加堆内存

# 增加最大堆内存
-Xmx8192m

# 增加初始堆内存
-Xms4096m

优化垃圾回收

# 使用G1垃圾回收器
-XX:+UseG1GC

# 设置最大暂停时间
-XX:MaxGCPauseMillis=200

检查内存泄漏

  1. 使用内存分析工具
  2. 检查对象创建模式
  3. 优化代码逻辑

数据问题​

数据导入失败​

症状​

  • 导入过程中断
  • 数据不完整
  • 格式错误

可能原因​

  1. 文件格式不支持
  2. 数据格式错误
  3. 文件损坏
  4. 权限问题

解决方案​

检查文件格式

  1. 确认文件格式支持
  2. 检查文件编码
  3. 验证文件完整性

检查数据格式

  1. 验证数据字段
  2. 检查数据类型
  3. 确认必填字段

使用导入工具

  1. 使用迁移导入工具
  2. 分批导入数据
  3. 验证导入结果

数据不一致​

症状​

  • 数据显示错误
  • 计算结果不准确
  • 数据丢失

解决方案​

数据验证

  1. 检查数据完整性
  2. 验证数据关系
  3. 运行数据一致性检查

数据修复

  1. 备份当前数据
  2. 运行修复脚本
  3. 验证修复结果

数据同步

  1. 检查数据同步状态
  2. 手动同步数据
  3. 验证同步结果

网络问题​

网络连接失败​

症状​

  • 无法连接到服务器
  • 网络超时
  • 连接不稳定

可能原因​

  1. 网络配置错误
  2. 防火墙阻止
  3. DNS解析问题
  4. 服务器不可达

解决方案​

检查网络连接

# 测试网络连通性
ping server.company.com

# 检查端口连接
telnet server.company.com 8080

# 检查DNS解析
nslookup server.company.com

检查防火墙设置

# 检查防火墙状态
sudo ufw status

# 允许应用程序端口
sudo ufw allow 8080

检查网络配置

# 检查网络接口
ifconfig

# 检查路由表
route -n

配置问题​

配置不生效​

症状​

  • 修改配置后无变化
  • 配置值不正确
  • 配置冲突

可能原因​

  1. 配置文件路径错误
  2. 配置语法错误
  3. 配置权限问题
  4. 需要重启服务

解决方案​

检查配置文件

# 检查配置文件路径
find / -name "application.properties" 2>/dev/null

# 检查配置文件权限
ls -la application.properties

验证配置语法

# 检查属性文件语法
java -cp . PropertiesValidator application.properties

重启服务

# 重启应用程序
sudo systemctl restart apriori

# 检查服务状态
sudo systemctl status apriori

配置冲突​

症状​

  • 多个配置文件冲突
  • 配置值不一致
  • 功能异常

解决方案​

检查配置优先级

  1. 确认配置文件加载顺序
  2. 检查环境变量覆盖
  3. 验证命令行参数

解决配置冲突

  1. 统一配置值
  2. 删除重复配置
  3. 使用配置继承

集成问题​

CAD集成失败​

症状​

  • 无法导入CAD文件
  • 属性提取失败
  • 格式不支持

可能原因​

  1. CAD文件格式不支持
  2. 文件损坏
  3. 版本不兼容
  4. 插件未安装

解决方案​

检查文件格式

  1. 确认文件格式支持
  2. 检查文件版本
  3. 验证文件完整性

安装插件

  1. 安装CAD集成插件
  2. 配置插件参数
  3. 测试集成功能

更新软件版本

  1. 检查软件版本兼容性
  2. 更新到最新版本
  3. 测试集成功能

外部系统集成失败​

症状​

  • 无法连接外部系统
  • 数据同步失败
  • API调用错误

解决方案​

检查连接配置

  1. 验证连接参数
  2. 检查网络连接
  3. 测试API接口

检查认证信息

  1. 验证API密钥
  2. 检查用户权限
  3. 确认认证方式

检查数据格式

  1. 验证数据格式
  2. 检查字段映射
  3. 确认编码格式

日志分析​

查看日志文件​

应用程序日志​

# 查看应用程序日志
tail -f apriori.log

# 搜索错误信息
grep "ERROR" apriori.log

# 查看最近的日志
tail -100 apriori.log

系统日志​

# 查看系统日志
sudo journalctl -u apriori

# 查看系统错误
sudo journalctl -p err

# 查看最近的系统日志
sudo journalctl --since "1 hour ago"

日志分析技巧​

  1. 时间分析：按时间顺序分析日志
  2. 错误模式：识别重复出现的错误
  3. 关联分析：关联多个日志文件
  4. 性能分析：分析性能相关日志

联系技术支持​

准备信息​

在联系技术支持之前，请准备以下信息：

  1. 问题描述：

    • 详细的问题描述
    • 问题发生的时间
    • 问题重现的步骤

  2. 系统信息：

    • 操作系统版本
    • Java版本
    • 几何成本估算软件版本

  3. 日志文件：

    • 应用程序日志
    • 系统日志
    • 错误截图

  4. 配置信息：

    • 相关配置文件
    • 环境变量设置
    • 网络配置

联系方式​

预防措施​

定期维护​

  1. 系统备份：

    • 定期备份数据
    • 备份配置文件
    • 测试备份恢复

  2. 性能监控：

    • 监控系统资源
    • 监控应用程序性能
    • 监控数据库性能

  3. 安全更新：

    • 定期更新软件
    • 更新安全补丁
    • 检查安全配置

最佳实践​

  1. 文档记录：

    • 记录配置变更
    • 记录问题解决过程
    • 维护操作手册

  2. 测试验证：

    • 在测试环境验证变更
    • 进行功能测试
    • 进行性能测试

  3. 培训教育：

    • 定期用户培训
    • 技术文档更新
    • 最佳实践分享