先确认现象#

先确认程序实际读取哪个 .env 文件，再确认服务进程是否重启。修改文件但不重启，运行中的进程通常不会自动拿到新值。

我会保留一条修复前命令，证明问题确实存在。这样修复后才能对比，而不是凭感觉判断。

排查命令#

1
printenv | sort | grep -E 'NODE_ENV|API|DATABASE'
2
systemctl show myapp --property=Environment
3
journalctl -u myapp -n 80 --no-pager

处理原则#

• 涉及服务器时，先备份配置或确认回滚方式。
• 涉及进程时，先判断它是不是线上服务。
• 涉及删除时，先用 du、ls、日志确认对象。
• 修完后必须做业务层验证，不只看报错消失。

复盘记录#

复盘记录里不要写真实密钥，只写变量名、配置位置和验证方式。敏感值不要放进博客和 Git。

最小验收样例#

我会记录修复前后的两条命令输出。比如端口问题就保存监听状态，权限问题就保存文件权限，服务问题就保存状态和日志。没有对比证据，就很难说明问题确实被解决。

如果操作发生在服务器上，还要写明当前用户、工作目录和影响范围。排查文章不是命令收藏夹，而是下一次可以照着走的现场记录。

小结#

部署时环境变量文件怎么检查 不是记一个命令，而是记一条排查链路。现象、命令、输出、验证都留下，下次才不用重新猜。