Enlightn运行缓慢耗时2分钟，生产环境执行致站点宕机求解决方案

配置信息 #

• Enlightn Pro版本：enlightn/enlightnpro": "1.*"
• Laravel版本：8
• PHP版本：8.1

问题描述 #

• 执行php artisan enlightn命令耗时极长（约2分钟）
• 生产环境执行该命令时，站点出现宕机情况

已尝试的无效解决步骤 #

• 曾配置队列（queue setup），但速度反而更慢，已卸载并移除队列相关配置
• 尝试调整内存限制执行命令：php -d memory_limit=512M artisan enlightn
• 多次卸载并重新安装Enlightn

其他观察结果 #

• 本地系统存储空间充足，无空间不足问题
• 其中一项检查耗时较长："非延迟加载的命令未使用构造函数注入"，该检查最终已通过

排查与解决方向 #

1. 缩小命令扫描范围
   Enlightn的命令检查会遍历所有自定义命令，若项目中命令数量多或部分命令的构造函数依赖过重（比如依赖大型Eloquent模型、外部服务实例），会大幅拖慢扫描速度。可以在config/enlightn.php中添加排除规则，跳过耗时的命令：

   'exclude' => [
       'commands' => [
           App\Console\Commands\YourHeavyCommand::class,
       ],
   ],
   

2. 优化生产环境执行策略
   生产环境执行时宕机，通常是因为Enlightn占用过多CPU、内存资源，和业务进程抢占资源导致。建议：

   • 选择业务低峰时段执行命令
   • 使用nice降低进程优先级，减少对业务的影响：nice -n 19 php artisan enlightn
   • 若使用PHP-FPM，临时调高FPM进程数上限，避免资源耗尽

3. 升级Enlightn到同分支最新版本
   1.*分支的早期版本可能存在性能瓶颈，尝试升级到1.*分支的最新稳定版（比如1.10.x），官方可能已修复命令检查的性能问题。

4. 单独定位慢检查项的根因
   针对耗时最长的"非延迟加载的命令未使用构造函数注入"检查，单独运行该检查来定位具体卡顿的命令：

   php artisan enlightn --check=EnlightnPro\Console\Checks\Commands\ConstructorInjectionCheck
   

   找到卡顿的命令后，针对性优化：比如将该命令改为延迟加载，或优化其依赖的初始化逻辑（比如避免在构造函数中执行数据库查询、API请求等操作）。

5. 优化PHP运行环境配置

   • 确保开启OPcache扩展，生产环境OPcache能大幅提升代码加载速度，调整php.ini相关配置：

     opcache.enable = 1
     opcache.enable_cli = 1
     opcache.memory_consumption = 128
     opcache.max_accelerated_files = 10000
     

   • 调大PHP的真实路径缓存，减少文件路径解析耗时：

     realpath_cache_size = 4096k
     realpath_cache_ttl = 3600
     

内容的提问来源于stack exchange，提问作者Prathna Mehta