使用Sentry CLI执行Symfony命令时环境变量未加载问题排查

核心原因 #

你遇到的问题本质是Symfony在通过sentry-cli执行命令时，没有正确加载.env.local中的APP_ENV=prod配置，导致强制使用了.env中的dev环境，进而尝试加载仅在dev环境启用的WebProfilerBundle（该Bundle作为dev依赖在prod环境未安装，因此报类未找到错误）。

可能的具体原因有两个：

1. 脚本执行的工作目录错误 #

Symfony的Dotenv组件默认从当前工作目录加载.env系列文件。如果你的bash脚本执行时不在项目根目录，Symfony会找不到.env.local，只能读取.env中的APP_ENV=dev，从而触发错误。
而你直接执行php bin/console时是在项目根目录，所以能正常加载.env.local的配置。

2. 子进程环境变量被覆盖 #

Symfony的Dotenv组件遵循环境变量优先于配置文件的规则：如果子进程（由sentry-cli启动的php进程）的环境中已经存在APP_ENV=dev，则会直接使用该值，忽略.env.local中的配置。
这种情况可能是sentry-cli在启动子进程时意外注入了APP_ENV=dev，或者脚本执行的shell环境中存在该变量（直接执行命令时未触发该问题，是因为当时未设置该环境变量，Symfony从配置文件读取值）。

解决方案 #

方案1：强制切换到项目根目录执行脚本 #

在bash脚本开头添加切换到项目根目录的命令，确保Symfony能找到.env.local：

#!/bin/bash
# 替换为你的Symfony项目根目录绝对路径
cd /absolute/path/to/your/symfony-project

# 读取并导出SENTRY_DSN
export SENTRY_DSN=$(grep -E '^SENTRY_DSN=' .env.local | cut -d '=' -f2)

# 执行sentry-cli命令
sentry-cli monitors run command-name -- php bin/console app:somecommand

方案2：显式指定APP_ENV环境变量 #

在执行php命令时，直接通过环境变量强制指定prod环境，绕过Dotenv的加载逻辑：

sentry-cli monitors run command-name -- APP_ENV=prod php bin/console app:somecommand

方案3：排查子进程环境变量 #

如果以上方案无效，可以通过打印子进程的环境变量确认问题：

#!/bin/bash
cd /path/to/your/project
echo "父进程APP_ENV: $APP_ENV"
export SENTRY_DSN=$(grep -E '^SENTRY_DSN=' .env.local | cut -d '=' -f2)

# 在sentry-cli中打印子进程环境变量
sentry-cli monitors run command-name -- bash -c 'echo "子进程APP_ENV: $APP_ENV"; php bin/console app:somecommand'

如果输出的子进程APP_ENV为dev，则需要检查sentry-cli是否有默认设置环境变量的行为，或者脚本执行的shell环境中是否存在残留的APP_ENV变量。

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