Apache监听多端口需显式修改httpd.conf中Listen指令，为每个端口配置独立VirtualHost并指向CI4的public目录，启用mod_rewrite及AllowOverride All，确保.env位于项目根目录且编码正确。
Apache Listen端口必须显式修改，否则所有虚拟主机共享80端口
CodeIgniter项目在XAMPP中启用多端口（如 8090、8091）部署的前提，是Apache本身监听多个端口。XAMPP默认只监听 80（或 443），不改配置就配再多 VirtualHost 也只会被路由到默认端口，甚至触发端口冲突或静默失败。
实操要点：
- 打开
XAMPP\apache\conf\httpd.conf，找到第58行左右的Listen 80，在其下方追加你需要的端口，例如：Listen 8090Listen 8091 - 每个新端口都必须对应一个独立的
<virtualhost></virtualhost>块，不能复用同一端口写多个VirtualHost - Windows下若提示“Address already in use”，先用
netstat -ano | findstr :8090查进程，再用taskkill /PID xxx /F杀掉占用者（常见是 Skype 或另一个 Apache 实例）
每个端口需配独立 VirtualHost，且 DocumentRoot 必须指向 CI4 的 public 目录
CodeIgniter 4 要求 Web 服务器根目录为 public/ 子目录，否则会报 Cannot find app/Config/App.php 或白屏。多端口部署时，每个 VirtualHost 的 DocumentRoot 和对应 <directory></directory> 必须严格匹配这一路径，不能指向项目根目录或 public/index.php 文件本身。
示例（httpd-vhosts.conf 末尾）：
<VirtualHost *:8090>
DocumentRoot "D:/projects/ci4-app1/public"
ServerName localhost:8090
<Directory "D:/projects/ci4-app1/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
<VirtualHost *:8091>
DocumentRoot "D:/projects/ci4-app2/public"
ServerName localhost:8091
<Directory "D:/projects/ci4-app2/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
注意：
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
-
ServerName写成localhost:8090是可选的，但推荐加上，避免 Apache 日志里出现警告 -
<directory></directory>路径必须与DocumentRoot完全一致，大小写和斜杠方向都要核对（Windows 下反斜杠\在配置中建议统一换成正斜杠/） - 别漏掉
AllowOverride All—— 这是让.htaccess生效的关键，缺了会导致所有非index.php路由 404
mod_rewrite 必须全局启用，且每个 VirtualHost 的 Directory 都要允许重写
CI4 的路由完全依赖 Apache 的 URL 重写能力。XAMPP 默认关闭 mod_rewrite，且即使启用，若某个 <directory></directory> 块里仍是 AllowOverride None，该端口下的项目仍会 404。
检查与修复步骤：
- 确认
httpd.conf中这行已取消注释：LoadModule rewrite_module modules/mod_rewrite.so - 查找所有
<directory></directory>块（不止是htdocs那个），把其中的AllowOverride None全部改为AllowOverride All - 重启 Apache 后，可在对应端口根目录放一个空
.htaccess文件测试：访问http://localhost:8090/.htaccess，如果返回 500 错误，说明重写未生效；如果 404 或 403，说明模块已启用但规则被拒绝或文件权限问题
.env 文件位置和编码错误会导致多端口项目全部卡在 production 模式
多个 CI4 项目共存于同一台 XAMPP 时，容易误以为只要改端口就互不影响。但实际中，若任一项目的 .env 文件因隐藏属性、BOM 头或放错位置（比如丢进了 public/），Apache 进程可能读取失败，导致所有项目退回到默认的 production 环境——表现为错误不显示、日志不生成、缓存路径写入失败，排查时极易误判为端口或路由问题。
关键动作：
-
.env必须位于项目根目录（与app/、public/同级），不是public/下，也不是htdocs/根下 - 右键 → 属性 → 取消勾选「隐藏」，避免 Windows 资源管理器自动忽略
- 用记事本打开 → 「另存为」→ 编码选「UTF-8」（不是 UTF-8-BOM），文件名填
.env（注意开头的点） - 内容至少包含：
CI_ENVIRONMENT = development，且不能有空格或中文标点
多端口部署真正麻烦的不是端口本身，而是每个端口背后都是一套独立的 Apache 上下文——DocumentRoot、Directory 权限、.htaccess 生效条件、环境变量加载路径，四者缺一不可。少改一行 AllowOverride 或多加一个 BOM，整个端口就变成黑盒。
