开源ERP企业管理系统常见问题解决方案指南

项目概述

aardio-erp是基于aardio10开发的企业管理系统框架，集成CGI源码、RPC服务端及客户端实现，支持多数据库交互，采用HTML、CSS、TSQL（Transact-SQL，数据库查询语言）及aardio脚本开发，提供完整的ERP框架部署与系统交互能力。

环境配置类问题

如何解决项目启动时自定义库缺失问题

现象描述：启动程序时控制台提示"找不到指定模块"或"library not found"，程序无法正常初始化。

排查步骤：

1. 检查项目目录下lib\carl\文件夹是否存在
2. 确认aardio IDE安装目录下lib\carl\文件夹结构是否完整
3. 对比两个目录下的文件数量和修改日期

解决方案：

1. 复制项目中的lib\carl\文件夹到aardio IDE安装目录的lib\文件夹下
2. 确保复制后的目录结构为[aardio安装路径]\lib\carl\，包含ctrl、report、rpc等子目录
3. 重启aardio IDE并重新加载项目

预防措施：

• 在项目文档中添加环境配置说明
• 使用版本控制工具管理依赖库版本
• 创建项目初始化脚本自动检查依赖完整性

常见误区：修改库文件名或目录结构以适应个人习惯，这会导致框架引用失败

CGI服务配置错误排查指南

现象描述：服务端部署后，客户端请求返回404错误或空白页面，无法处理CGI请求。

排查步骤：

1. 检查IIS管理器中是否已创建正确的应用程序池
2. 验证模块映射是否指向wwwroot\aardio-cgi\exe
3. 查看IIS日志文件确认请求处理状态

解决方案：

1. 重新配置IIS模块映射：
   • 请求路径：*.aardio
   • 模块：FastCgiModule
   • 可执行文件：[项目路径]\wwwroot\aardio-cgi\exe
2. 配置FastCGI设置，确保进程池标识具有正确权限
3. 重启IIS服务使配置生效

预防措施：

• 保存IIS配置备份
• 记录配置步骤到部署文档
• 使用批处理脚本自动化配置过程

功能异常类问题

数据库连接失败解决方案

现象描述：客户端启动后提示"数据库连接失败"，无法加载系统数据。

排查步骤：

1. 确认数据库服务是否正常运行
2. 检查服务端配置文件wwwroot\system\config\aardio中的连接参数
3. 验证客户端配置文件lib\config\aardio中的数据库类型设置

解决方案：

1. 服务端配置检查：
   • 确保config __drive值与数据库类型匹配（mssql/mysql/oracle）
   • 验证config __server、config __database、config __uid、config __pwd参数正确性
2. 客户端配置调整：

   config __drive = "mysql"  -- 与服务端保持一致
   config __appRoad = "default"  -- 确保线路配置正确
   

3. 测试数据库连接：使用数据库客户端工具验证连接参数

预防措施：

• 使用配置文件模板区分开发/生产环境
• 实现数据库连接测试功能
• 记录数据库连接日志便于问题追踪

常见误区：服务端与客户端数据库类型配置不一致，如服务端使用MySQL而客户端配置为MSSQL

系统菜单功能异常处理指南

现象描述：登录系统后菜单无法展开或点击无响应，控制台无错误提示。

排查步骤：

1. 检查lib\web\layout\behavior\main\systemMenu.aardio文件是否存在
2. 验证用户权限配置是否正确
3. 查看浏览器开发者工具网络请求状态

解决方案：

1. 重新部署res\System\Menu.aardio组件
2. 执行数据库脚本修复菜单权限表：

   -- 适用于MSSQL
   exec sp_refreshmenupermission @userid=1
   

3. 清除浏览器缓存并重启客户端

预防措施：

• 定期备份权限配置数据
• 实现菜单加载失败自动恢复机制
• 在开发环境中模拟各种权限场景测试

数据交互类问题

RPC服务调用失败排查方案

现象描述：客户端操作时提示"RPC调用失败"，无法完成数据提交或查询。

排查步骤：

1. 检查RPC服务端是否正常运行
2. 验证aardio-rpc\config.aardio中的端口配置
3. 测试网络连通性，确保客户端能访问服务端端口

解决方案：

1. 重启RPC服务端：

   cd [项目路径]\aardio-rpc
   start main.aardio
   

2. 检查防火墙设置，确保RPC端口（默认为8080）开放
3. 重新生成密钥文件：

   cd [项目路径]\aardio-rpc
   aardio keygen.aardio
   

预防措施：

• 实现RPC服务健康检查机制
• 配置服务自动重启脚本
• 记录详细的RPC调用日志

报表生成异常处理方法

现象描述：执行报表生成功能时程序卡顿或输出空白报表。

排查步骤：

1. 检查lib\carl\report\template.aardio模板文件完整性
2. 验证报表SQL查询语句是否正确
3. 确认数据库中是否存在所需数据

解决方案：

1. 修复报表模板文件：

   -- 重新复制模板文件
   copy [项目路径]\lib\carl\report\template.aardio [安装路径]\lib\carl\report\
   

2. 优化报表查询SQL，添加必要索引
3. 增加报表生成超时处理机制

预防措施：

• 定期维护报表模板
• 对大型报表实现异步生成
• 限制单次查询数据量

系统部署与维护

多环境部署配置指南

现象描述：在不同环境（开发/测试/生产）切换时系统配置需要频繁修改。

排查步骤：

1. 检查是否存在环境配置文件分离机制
2. 确认配置加载逻辑是否正确识别环境变量

解决方案：

1. 创建环境配置文件：
   • config.dev.aardio（开发环境）
   • config.test.aardio（测试环境）
   • config.prod.aardio（生产环境）
2. 修改配置加载代码：

   var env = os.getenv("ERP_ENV") || "dev"
   import config = "config."+env
   

3. 配置环境变量：

   # Linux
   export ERP_ENV=prod
   
   # Windows
   set ERP_ENV=prod
   

预防措施：

• 环境配置文件加入版本控制
• 编写部署脚本自动切换环境配置
• 敏感配置使用环境变量注入

系统更新与升级注意事项

现象描述：系统升级后出现功能异常或数据丢失风险。

排查步骤：

1. 检查更新日志了解变更内容
2. 确认数据库结构变更脚本是否完整
3. 验证备份数据可用性

解决方案：

1. 升级前准备：
   1. 备份数据库：mysqldump -u root -p erp > backup_20230101.sql
   2. 备份配置文件：copy config.aardio config.aardio.bak
2. 执行升级：

   git pull origin main
   aardio update.aardio
   

3. 升级后验证：
   1. 运行数据库迁移脚本
   2. 执行系统自检程序
   3. 测试核心功能模块

预防措施：

• 制定详细的升级计划和回滚方案
• 在测试环境验证升级包
• 升级过程中监控系统日志