Azure DevOps发布流水线.env变量替换后无法读取问题求助

排查步骤与解决方案 #

1. 确认构建输出是否包含.env文件 #

• 检查构建任务（如npm run build）的配置：前端项目（React/Vue等）需确保.env文件被复制到构建输出目录（通常是dist或build）。可通过在构建脚本中添加copyfiles .env dist/（需先安装copyfiles包），或在webpack/vite配置中添加文件拷贝规则。
• 下载Azure DevOps构建生成的Artifact，解压后检查是否存在替换后的.env文件，确认文件路径和内容是否正确。

2. 验证发布流水线的文件处理逻辑 #

• 确保Replace tokens任务的目标文件路径指向构建输出目录中的.env，而非源码目录下的文件。例如：如果构建输出在$(Build.ArtifactStagingDirectory)/dist，则任务的目标路径应设为$(Build.ArtifactStagingDirectory)/dist/.env。
• 检查部署任务（如Azure App Service部署）的“包或文件夹”配置，确保包含.env所在的路径，没有排除该文件。

3. 核对应用读取.env的时机 #

• 如果是前端应用：部分框架（如React）的环境变量是构建时注入的（以REACT_APP_前缀为例），此时替换.env文件无效。需改为在构建阶段通过Azure DevOps变量直接注入，或在部署时设置App Service的应用程序配置（环境变量）。
• 如果是Node.js后端：确认应用启动时读取的是部署目录下的.env文件，而非源码路径。可在启动脚本中指定.env路径，如node -r dotenv/config server.js dotenv_config_path=./.env，或检查dotenv包的配置是否正确指向当前工作目录。

4. 检查部署目标的实际文件 #

• 对于Azure App Service，通过Kudu工具（高级工具 -> 前往）进入site/wwwroot目录，查看是否存在.env文件，以及内容是否为替换后的值。
• 若部署到虚拟机/容器，登录后直接检查部署目录下的.env文件状态。

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