Laravel 12运行PHPUnit测试时始终使用local环境问题排查

• Docker容器环境变量优先级覆盖：Laravel会优先读取系统级环境变量，如果容器启动时被传入APP_ENV=local，会直接覆盖phpunit配置和.env.testing的设置，导致测试时始终用local环境。
• PHPUnit配置未生效：phpunit.xml里的<env name="APP_ENV" value="testing"/>可能被注释、写错位置，或者容器内的配置文件被本地挂载的文件覆盖，没起到作用。
• 缓存清理不彻底：只执行cache:clear不够，配置缓存没清；或者容器挂载了本地的bootstrap/cache目录，本地残留的缓存会持续影响容器内环境。
• .env.testing文件问题：容器内不存在该文件、权限不足，或者文件里没正确设置APP_ENV=testing，Laravel fallback到主.env读取配置。

• 修正Docker环境变量
  用docker exec <容器ID> printenv APP_ENV查看容器内当前的APP_ENV值。如果是local，修改Docker启动配置（比如docker-compose.yml），要么移除APP_ENV=local的设置，要么明确设为testing；测试阶段建议给容器单独配置测试环境变量，避免和本地环境混淆。
• 检查PHPUnit配置
  打开容器内的phpunit.xml，确认<php>节点下有如下配置，且未被注释：

  <env name="APP_ENV" value="testing"/>
  <env name="DB_CONNECTION" value="sqlite"/>
  <env name="DB_DATABASE" value=":memory:"/>
  

  （用内存sqlite可以彻底避免误删本地数据库的问题）
• 彻底清理容器内缓存
  进入容器执行全套清缓存命令：

  docker exec <容器ID> php artisan config:clear
  docker exec <容器ID> php artisan cache:clear
  docker exec <容器ID> php artisan route:clear
  docker exec <容器ID> php artisan view:clear
  

  如果你的Docker挂载了本地的bootstrap/cache目录，测试时暂时取消挂载，防止本地缓存干扰容器内的测试环境。
• 验证.env.testing有效性
  进入容器检查文件是否存在：docker exec <容器ID> ls -l .env.testing，确认文件里APP_ENV=testing，且数据库配置指向测试专用库；同时确保文件权限正常：docker exec <容器ID> chmod 644 .env.testing。
• 强制指定环境执行测试
  直接在容器内用环境变量强制指定测试环境运行命令：

  docker exec <容器ID> APP_ENV=testing php artisan test
  

  或者在docker-compose.yml的服务配置里固定测试环境变量：

  services:
    app:
      environment:
        - APP_ENV=testing
        - DB_CONNECTION=sqlite
        - DB_DATABASE=:memory:
  

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