生产环境Pusher引用开发密钥问题排查与求助

问题描述 #

生产环境执行Echo.private('App.Models.User.1')时，发现Pusher使用的是本地开发环境.env中的PUSHER_APP_KEY，而非生产环境配置的正确密钥，手动修改生产环境public/js/app.js中的密钥后Pusher恢复正常，但每次通过GitHub Actions部署时会被覆盖。本地开发环境一切正常。

配置与构建背景 #

• bootstrap.js通过process.env.MIX_PUSHER_APP_KEY和process.env.MIX_PUSHER_APP_CLUSTER获取Pusher配置，本地执行npm run dev时，密钥会硬编码到app.js中。
• GitHub Actions构建流程中，复制.env.example作为构建用.env，该文件内PUSHER相关变量为空，MIX_系列变量通过${PUSHER_APP_KEY}引用空值。
• 尝试通过GitHub Secret配置完整.env文件时，出现解析错误："The environment file is invalid! Failed to parse dotenv file. Encountered unexpected whitespace"

解决方案 #

1. 直接在GitHub Actions中注入生产环境MIX变量 #

放弃通过.env.example间接引用变量的方式，在构建步骤中直接注入生产环境的MIX_前缀变量，确保打包时使用生产密钥：

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 安装PHP依赖
        run: composer install --no-dev --optimize-autoloader

      - name: 安装Node依赖
        run: npm ci

      - name: 注入生产环境变量并构建前端资源
        env:
          MIX_PUSHER_APP_KEY: ${{ secrets.PROD_PUSHER_APP_KEY }}
          MIX_PUSHER_APP_CLUSTER: ${{ secrets.PROD_PUSHER_APP_CLUSTER }}
        run: npm run prod

      # 后续部署步骤（如上传到服务器等）

2. 修正.env.example的变量引用格式 #

如果需要保留.env.example作为模板，确保变量引用用双引号包裹，避免空白字符解析错误：

# .env.example
PUSHER_APP_KEY=
PUSHER_APP_CLUSTER=
MIX_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
MIX_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"

3. 确保本地.env不被提交到仓库 #

检查.gitignore是否包含.env，防止本地开发密钥被误提交到仓库，导致构建时读取错误：

# .gitignore
.env

4. 修复GitHub Secret的.env内容格式 #

如果必须通过Secret生成完整.env文件，确保Secret中的内容无多余空白字符，变量格式严格为KEY=VALUE（无空格）：

# Secret中正确的.env内容格式
APP_NAME=你的应用名
PUSHER_APP_KEY=生产环境密钥
PUSHER_APP_CLUSTER=生产环境集群
MIX_PUSHER_APP_KEY=生产环境密钥
MIX_PUSHER_APP_CLUSTER=生产环境集群

然后在GitHub Actions中写入.env：

- name: 生成生产环境.env文件
  run: echo "${{ secrets.PROD_ENV_FILE }}" > .env

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