AureusERP 安装过程中 SQLite 数据库表缺失问题解析

问题现象

在使用 AureusERP 系统执行安装命令 php artisan erp:install 时，系统报错提示找不到 custom_fields 数据表。错误信息明确指出 SQLite 数据库连接存在问题，系统尝试查询 custom_fields 表时发现该表不存在。

问题根源分析

这个错误通常发生在以下情况：

1. 数据库迁移未正确执行：在执行安装命令前，必要的数据库迁移可能没有完成，导致关键表缺失。

2. SQLite 数据库配置问题：项目可能默认使用 SQLite 作为开发环境数据库，但数据库文件未正确初始化。

3. 安装流程顺序问题：系统可能在执行某些业务逻辑前假设数据库表已存在，而实际上尚未创建。

解决方案

完整安装步骤

1. 确保数据库配置正确：

   • 检查 .env 文件中的数据库配置
   • 对于 SQLite，确保 DB_DATABASE 指向有效的数据库文件路径

2. 执行数据库迁移：

   php artisan migrate
   

3. 运行安装命令：

   php artisan erp:install
   

针对 SQLite 的特殊处理

如果使用 SQLite 数据库，需要额外注意：

1. 确保数据库文件存在且有写入权限
2. 检查 database 目录是否存在
3. 可以手动创建 SQLite 数据库文件：

   touch database/database.sqlite
   

预防措施

1. 开发环境建议：对于开发环境，建议使用 MySQL 或 PostgreSQL 而非 SQLite，以避免潜在的兼容性问题。

2. 安装前检查：在执行安装命令前，可以先运行 php artisan migrate:status 检查迁移状态。

3. 环境准备脚本：可以创建自动化脚本确保环境准备就绪：

   #!/bin/bash
   touch database/database.sqlite
   php artisan migrate
   php artisan erp:install
   

技术背景

AureusERP 系统使用 Laravel 框架开发，其安装过程涉及：

1. 数据库迁移：创建系统所需的表结构
2. 数据填充：插入必要的初始数据
3. 系统配置：设置基本参数和选项

custom_fields 表是系统中用于存储自定义字段的重要组件，通常在早期迁移中创建。如果该表缺失，说明迁移过程可能被跳过或未完成。

总结

AureusERP 安装过程中的表缺失问题通常可以通过正确的安装流程解决。开发者应确保数据库配置正确并完整执行所有迁移。对于生产环境，建议使用更稳定的数据库系统，并在部署前充分测试安装流程。