Codeigniter4经composer升级4.2后index.php报run()调用致命错误

根因说明 #

该报错和PHP扩展缺失、.env配置、App.php配置无关。PHP中require/include加载文件时如果文件无显式return值，会默认返回整型1，报错里提到的调用run()方法的变量拿到的是int值而非CI4应用实例，说明框架引导流程中断，核心原因是升级时仅更新了composer依赖的框架核心包，未同步更新项目骨架中版本适配的引导文件。

排查修复步骤 #

• 核对public/index.php文件内容
  不要仅凭记忆判断文件未改动，CI4.2版本对前端控制器的加载逻辑做了不兼容调整，4.1版本的旧index.php无法适配4.2核心。直接对照4.2版本官方骨架的public/index.php替换对应文件，核心正确逻辑片段如下：

  // 加载路径配置文件
  $pathsPath = FCPATH . '../app/Config/Paths.php';
  require $pathsPath;
  $paths = new Config\Paths();
  
  // 加载框架引导文件，该步骤会返回应用实例
  $app = require rtrim($paths->systemDirectory, '/ ') . '/bootstrap.php';
  
  // 启动应用
  $app->run();
  

  替换时注意保留站点自身的路径自定义配置，不要硬改路径导致找不到文件。
• 核对app/Config/Paths.php文件
  这是升级时最高发的遗漏点：CI4.2调整了Paths类的属性定义规则，4.1版本的Paths.php会导致bootstrap引导流程无法正确初始化，最终返回int(1)而非应用实例。直接用4.2版本骨架中的Paths.php覆盖原文件，再把之前自定义的系统目录、应用目录等路径配置重新填回去即可，不要直接沿用4.1版本的旧Paths文件。
• 清理旧版本缓存
  替换完核心文件后，删除writable/cache/目录下除index.html外的所有文件，清空旧版本生成的配置缓存、服务缓存，避免缓存类加载逻辑冲突。也可以在项目根目录执行命令清理：

  php spark cache:clear
  

  如果命令执行报错，手动删缓存文件即可。
• 重载服务与依赖
  执行composer自动加载重载命令，避免类映射不匹配：

  composer dump-autoload
  

  重启Apache服务后重新访问站点验证。

注意点 #

后续跨小版本升级CI4时，除了执行composer update外，需要对照官方升级指引检查项目骨架下的public/index.php、spark、app/Config/下的核心配置文件是否有结构调整，不要直接沿用所有旧项目文件，否则很容易出现兼容问题。

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