核心是app_env变量驱动环境行为：dev启用调试工具、详细错误页；prod强制缓存、禁用调试、隐藏错误，且必须设app_debug=0、清缓存、编译资产。
切换 Symfony 7.4 的开发与生产环境，核心在于三件事：环境变量控制、自动加载优化、资产编译状态。不是改几行代码就完事，而是整套行为逻辑随 APP_ENV 变量联动变化。
一、关键配置项必须统一指向 APP_ENV
所有环境差异最终由 .env 文件中的 APP_ENV 决定，其他配置应与其保持一致：
-
APP_ENV=dev→ 自动启用调试工具栏、Profiling、详细错误页；APP_DEBUG=1会被自动设为 true（无需手动写） -
APP_ENV=prod→ 强制关闭调试、禁用 Profiler、使用缓存化容器和路由；APP_DEBUG必须显式设为0（否则会报错） -
APP_SECRET在两个环境中必须不同，且 prod 环境下严禁使用默认值或空字符串 - 数据库 URL 中的
serverVersion参数建议明确指定（如?serverVersion=8.0），避免 Doctrine 在 prod 下因版本探测失败而缓存异常
二、命令行操作要区分环境上下文
同一条命令在不同环境下行为完全不同，不能复用 dev 命令直接跑 prod：
- 启动服务：
php bin/console server:run仅限 dev；prod 必须用 Web 服务器（Nginx/Apache）+public/index.php - 清除缓存：
php bin/console cache:clear在 dev 下默认不加参数即可；prod 下必须加--env=prod或先设APP_ENV=prod，否则清的是 dev 缓存 - 构建资产：
npm run build或php bin/console assetic:dump（若用 Assetic）只在 prod 需要执行；dev 下通常走 Webpack Dev Server - 查看路由：
php bin/console debug:router在 prod 下会跳过未匹配的路由定义，结果比 dev 更精简，适合验证最终生效路径
三、生产部署前必做的四步验证
光改环境变量不够，必须逐项确认运行时表现：
- 执行
php bin/console about，检查输出中 Environment 显示prod，Debug 显示false - 运行
php bin/console config:dump-reference framework，确认profiler和web_profiler相关配置为 null 或 false - 访问
public/index.php（不要带app_dev.php），页面底部不应出现 Web Debug Toolbar - 查看
var/cache/prod/目录是否存在且非空，特别是Container*和UrlMatcher*文件是否生成成功
四、常见误操作与修复方式
这些错误高频出现，往往导致 500 错误却无日志提示：
- 忘记设 APP_DEBUG=0：prod 下不设此项，Symfony 会拒绝启动，报 “Debug mode is disabled in production”
-
缓存未清除干净：改完 .env 后没清缓存，旧 dev 容器仍被加载；应删掉整个
var/cache/目录再试 -
前端资产路径错误：prod 下
assets:install默认复制而非符号链接，需确保public/build/存在且可读 -
PHP 扩展缺失：prod 常启用 OPcache，但若
opcache.enable_cli=1未关，bin/console命令可能因缓存旧字节码而执行异常
