开源ERP框架aardio-erp 3大启动故障排查方案

一、环境配置问题：程序无法启动怎么办？

💡 症状描述

尝试运行项目时程序无响应，控制台提示"缺少自定义库"错误，aardio IDE可能出现模块加载失败提示。

🔍 检查项

• 确认项目目录下是否存在 lib/carl/ 文件夹
• 检查 aardio IDE 安装目录的 lib/ 文件夹中是否已有 carl 目录

🛠️ 操作步骤

1. 找到项目中的库文件目录 lib/carl/
2. 将整个 carl 文件夹复制到 aardio IDE 的标准库目录（通常位于 IDE 安装路径下的 lib/ 文件夹）
3. 重启 aardio IDE 使配置生效

graph LR
A[找到项目lib/carl] --> B[复制到IDE的lib目录]
B --> C[重启aardio IDE]

二、服务连接问题：CGI请求无法处理怎么办？

💡 症状描述

服务端环境配置完成后，通过浏览器访问系统时出现404错误或空白页面，服务器日志显示CGI执行失败。

🔍 检查项

• IIS服务是否正常运行
• 模块映射是否正确指向 wwwroot/aardio-cgi/exe
• FastCGI设置是否正确配置

🛠️ 操作步骤

1. 打开IIS管理器，检查网站模块映射配置，确保 .cgi 扩展名已关联到正确的执行文件
2. 验证 wwwroot/aardio-cgi/ 目录下的脚本文件路径是否正确，无拼写错误
3. 在IIS的FastCGI设置中确认可执行文件路径与项目中的CGI程序匹配

三、数据交互问题：数据库连接失败解决

💡 症状描述

客户端启动后提示"无法连接数据库"，或登录界面输入信息后无响应，服务端日志显示数据库连接超时。

🔍 检查项

• 数据库服务是否已启动并可访问
• 服务端配置文件中的连接参数是否正确
• 客户端与服务端的数据库配置是否匹配

🛠️ 操作步骤

1. 导入数据库安装文件：执行项目根目录下的 aardio-erp-mssql.sql 或 aardio-erp-mysql(utf8,InnoDB).sql
2. 修改服务端配置 wwwroot/system/config/aardio，确保数据库地址、用户名和密码正确
3. 检查客户端配置 lib/config/aardio，确认 config __drive（数据库类型）和 config __appRoad（线路）与服务端一致

注意事项

• 所有配置修改后建议重启相关服务使设置生效
• 数据库连接问题请优先检查网络连通性和防火墙设置
• 若问题持续，可查看项目根目录下的日志文件获取详细错误信息

提示：项目仓库地址为 https://gitcode.com/gh_mirrors/aa/aardio-erp，可通过 git clone 命令获取完整源码