Composer安装/更新时遇PHP致命错误：无法读取.env文件求助

问题概述 #

执行composer install或composer update时触发cache:clear脚本失败，返回错误码255，核心错误为无法读取指定路径的.env环境文件，涉及路径分别为/home/marc/Desktop/colcot/colcot-2022/Colcot/.env和/var/www/.env，报错堆栈如下：

本地环境报错

Executing script cache:clear [KO]
 [KO]
Script cache:clear returned with error code 255
!!  PHP Fatal error:  Uncaught Symfony\Component\Dotenv\Exception\PathException: Unable to read the "/home/marc/Desktop/colcot/colcot-2022/Colcot/.env" environment file. in /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/symfony/dotenv/Dotenv.php:569
!!  Stack trace:
!!  #0 /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/symfony/dotenv/Dotenv.php(92): Symfony\Component\Dotenv\Dotenv->doLoad()
!!  #1 /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/symfony/dotenv/Dotenv.php(114): Symfony\Component\Dotenv\Dotenv->load()
!!  #2 /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/symfony/dotenv/Dotenv.php(157): Symfony\Component\Dotenv\Dotenv->loadEnv()
!!  #3 /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/symfony/runtime/SymfonyRuntime.php(102): Symfony\Component\Dotenv\Dotenv->bootEnv()
!!  #4 /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/autoload_runtime.php(23): Symfony\Component\Runtime\SymfonyRuntime->__construct()
!!  #5 /home/marc/Desktop/colcot/colcot-2022/Colcot/bin/console(11): require_once('/home/marc/Desk...')
!!  #6 {main}
!!    throw in /home/marc/Desktop/colcot/colcot-2022/Colcot/vendor/symfony/dotenv/Dotenv.php on line 569
!!  
Script @auto-scripts was called via post-install-cmd

服务器环境报错

Fatal error: Uncaught Symfony\Component\Dotenv\Exception\PathException: Unable to read the "/var/www/.env" environment file. in /var/www/vendor/symfony/dotenv/Dotenv.php:569 Stack trace: #0 /var/www/vendor/symfony/dotenv/Dotenv.php(92): Symfony\Component\Dotenv\Dotenv->doLoad(false, Array) #1 /var/www/vendor/symfony/dotenv/Dotenv.php(114): Symfony\Component\Dotenv\Dotenv->load('/var/www/.env') #2 /var/www/vendor/symfony/dotenv/Dotenv.php(157): Symfony\Component\Dotenv\Dotenv->loadEnv('/var/www/.env', 'APP_ENV', 'dev', Array) #3 /var/www/vendor/symfony/runtime/SymfonyRuntime.php(102): Symfony\Component\Dotenv\Dotenv->bootEnv('/var/www/.env', 'dev', Array) #4 /var/www/vendor/autoload_runtime.php(23): Symfony\Component\Runtime\SymfonyRuntime->__construct(Array) #5 /var/www/public/index.php(5): require_once('/var/www/vendor...') #6 {main} thrown in /var/www/vendor/symfony/dotenv/Dotenv.php on line 569

解决步骤 #

1. 确认.env文件存在

项目通常会提供.env.example模板文件，直接复制并重命名为.env即可：

• Linux/macOS终端执行：

  # 切换到项目根目录
  cd /home/marc/Desktop/colcot/colcot-2022/Colcot/
  # 复制模板文件
  cp .env.example .env
  

• Windows系统：手动找到.env.example文件，复制后改名为.env

2. 修复文件权限

如果.env文件已存在但仍报错，说明PHP进程没有读取权限：

• 调整文件可读权限：

  chmod 644 /home/marc/Desktop/colcot/colcot-2022/Colcot/.env
  # 服务器环境路径对应调整
  chmod 644 /var/www/.env
  

• 服务器环境还需确保文件归属web进程用户（如www-data）：

  chown www-data:www-data /var/www/.env
  

3. 临时跳过自动脚本（优先完成Composer安装）

若需先完成依赖安装，可跳过Composer的post-install脚本：

composer install --no-scripts

安装完成后，再手动处理.env文件，最后执行缓存清理：

php bin/console cache:clear

4. 验证.env路径配置

检查项目入口文件（如bin/console或public/index.php）中bootEnv方法的参数，确认指定的.env路径是否正确，避免硬编码错误的绝对路径。

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