GLPI项目安装过程中插件检查导致安装失败的解决方案

问题背景

在GLPI项目的最新main分支版本安装过程中，部分开发者遇到了一个严重的安装阻断问题。当尝试进行全新安装时，系统会在数据库表尚未完全创建的情况下，提前执行插件状态检查，导致安装过程中断并抛出MySQL表不存在的错误。

错误现象

安装过程中系统会抛出以下关键错误信息：

MySQL query error: Table 'glpifresh.glpi_plugins' doesn't exist (1146) in SQL query "SELECT * FROM `glpi_plugins` WHERE `state` = '1'"

这表明系统在glpi_plugins表尚未创建时就尝试查询该表内容，导致安装流程中断。

问题根源分析

经过技术团队深入调查，发现问题主要源于以下两个场景：

1. SKIP_UPDATES常量设置不当：当开发者在local_define.php中设置了SKIP_UPDATES=true常量时，会跳过正常的更新流程，但同时也影响了安装过程中的表创建顺序。

2. 混合环境安装：在已有部分GLPI表结构但不完整的数据库上执行全新安装时，系统错误地认为插件表已存在，提前执行了插件状态检查。

解决方案

针对这一问题，GLPI开发团队已经发布了修复方案：

1. 修正安装流程顺序：确保在数据库表完全初始化完成后再执行插件状态检查。

2. 优化常量检测逻辑：改进SKIP_UPDATES常量的处理方式，避免影响全新安装流程。

3. 增强错误处理机制：在表不存在时提供更友好的错误提示而非直接中断安装。

最佳实践建议

对于开发者和管理员，建议采取以下措施避免类似问题：

1. 全新安装时：

   • 确保使用全新的空数据库
   • 检查local_define.php中未设置SKIP_UPDATES常量
   • 按照标准安装流程操作

2. 开发环境配置：

   • 区分开发环境和生产环境的配置
   • 避免将开发用的常量设置带入生产安装流程

3. 故障排查：

   • 安装失败时检查数据库表是否完整创建
   • 查看日志获取更详细的错误信息

技术实现细节

修复方案主要涉及以下技术点：

1. 事件监听器调整：修改了InitializePlugins监听器的执行时机，确保在数据库完全初始化后执行。

2. 条件检测优化：在插件系统初始化前增加数据库表存在性检查。

3. 安装流程重构：将插件检查步骤移至表创建完成后的阶段执行。

该修复已合并到GLPI主分支，开发者更新到最新代码后即可解决此安装问题。