当执行 php spark serve 报错“Argument 1 passed to CodeIgniter\CLI\Console::__construct() must be an instance of CodeIgniter\CodeIgniter”时，通常是因项目根目录缺失正确版本的 spark 文件或 public/index.php 不匹配框架核心所致。

当执行 `php spark serve` 报错“argument 1 passed to codeigniter\cli\console::__construct() must be an instance of codeigniter\codeigniter”时，通常是因项目根目录缺失正确版本的 `spark` 文件或 `public/index.php` 不匹配框架核心所致。

该错误本质是 CLI 控制台类在初始化时接收到一个整数（如 1）而非预期的 CodeIgniter\CodeIgniter 实例，根本原因在于当前项目使用的 spark 脚本与已安装的 CodeIgniter 4 框架版本不兼容——常见于通过 Composer 安装第三方库（如 endroid/qr-code）后，项目结构被意外覆盖，或初始安装未正确复制核心可执行文件。

✅ 正确修复步骤

请按顺序执行以下操作（以 Windows 或类 Unix 环境通用）：

1. 恢复正确的 spark 入口脚本
   将框架源码中的官方 spark 文件复制到项目根目录，确保 CLI 工具与当前 vendor/codeigniter4/framework/ 版本严格对应：

   # Linux/macOS
   cp vendor/codeigniter4/framework/spark .
   
   # Windows（PowerShell 或 CMD）
   copy vendor\codeigniter4\framework\spark .

2. 同步 public/index.php
   替换项目 public/index.php 为框架提供的标准入口文件，避免因自定义或旧版入口导致 CodeIgniter 实例未正确创建：

   # Linux/macOS
   cp vendor/codeigniter4/framework/public/index.php public/index.php
   
   # Windows
   copy vendor\codeigniter4\framework\public\index.php public\index.php

⚠️ 注意：切勿直接编辑 spark 或 index.php 文件内容；务必使用 vendor/codeigniter4/framework/ 下对应版本的原始文件。若项目中已存在 spark，建议先备份再覆盖。

? 验证与补充说明

执行修复后，运行：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

php spark --version

应输出类似 CodeIgniter v4.x.x 的版本号，确认 CLI 工具已正常加载。随后即可安全启动开发服务器：

php spark serve

此外，该问题与第三方库（如 endroid/qr-code）无直接关联——它只是触发了项目结构不一致的暴露点。建议后续通过 Composer 安装依赖时，避免手动移动框架核心文件，并定期运行 composer install --no-dev（生产环境）或 composer update（开发环境）保持一致性。

如仍报错，请检查 composer.json 中 codeigniter4/framework 的版本是否锁定（如 ^4.4），并执行 composer dump-autoload 刷新自动加载映射。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！