Codeigniter 4部署至生产服务器后环境设置错误的排查与解决

错误原因 #

• Apache用户权限不足：本地用php spark serve是当前用户执行，能正常读取根目录的.env文件，但Apache运行用户（一般是www-data）没有该文件的读取权限，导致环境配置加载失败。
• .env路径解析异常：把/public设为Apache主目录后，CodeIgniter默认从public/index.php的上级目录找.env，如果服务器目录结构或Apache配置导致路径解析错误，就找不到配置文件。
• .htaccess未生效：Apache的AllowOverride未开启，导致public/.htaccess里的规则不生效，影响CodeIgniter的环境初始化流程。

解决步骤 #

1. 修复文件权限 #

给.env文件设置可读权限，同时确保Apache用户能访问：

# 设置.env文件权限
chmod 644 /你的项目根目录/.env
# 可选：把项目目录所有者改为Apache用户
chown -R www-data:www-data /你的项目根目录

2. 确认.env文件路径 #

打开public/index.php，检查加载.env的逻辑。默认代码是从FCPATH（即/public）的上级目录加载，如果路径不对，手动指定绝对路径：

// 在index.php开头添加这段代码
$envAbsolutePath = '/服务器上的项目根目录/.env';
if (file_exists($envAbsolutePath)) {
    $dotenv = Dotenv\Dotenv::createImmutable(dirname($envAbsolutePath));
    $dotenv->load();
}

3. 开启Apache的AllowOverride #

编辑你的Apache站点配置文件（比如/etc/apache2/sites-available/你的站点.conf），确保配置如下：

<Directory /你的项目根目录/public>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

然后重启Apache：

sudo systemctl restart apache2

4. 手动设置环境变量（备选方案） #

如果以上方法都不行，直接在public/index.php里硬编码环境变量：

// 在index.php开头添加
define('CI_ENVIRONMENT', 'production');

内容的提问来源于stack exchange，提问作者Bünyamin Pollin