Shopify CLI中.ENV自定义MongoDB变量被Shopify Serve重写的解决方案

这是Shopify CLI的固有设计逻辑：工具启动服务时只会保留、重写它识别的应用系统类配置变量，所有未被提前声明的手动新增自定义变量都会被清空，不属于操作失误，直接按照下面的方案处理即可。

方案1：独立存储自定义环境变量（最省心） #

• 不要把MongoDB相关配置写到Shopify CLI维护的根目录.env文件里，单独创建一个.env.local文件，把所有MongoDB配置项（比如MONGODB_URI、MONGODB_DB_NAME）写在这个独立文件里
• 在项目服务端入口的最顶端（比如Node服务的启动文件、Remix框架的服务端入口文件）主动加载这个文件的配置：
  1. 先安装dotenv依赖：npm install dotenv
  2. 在入口代码最顶部添加加载逻辑：

     import dotenv from 'dotenv';
     // 加载独立的本地自定义配置
     dotenv.config({ path: '.env.local' });
     

• 最后把.env.local加入.gitignore文件，避免敏感配置被提交到代码仓库
• 这个方案的核心优势是Shopify Serve的重写逻辑完全不会扫描、修改.env.local文件，不管重启多少次服务，配置都不会丢失。

方案2：在主.env中保留自定义变量（官方支持的方式） #

如果一定要把MongoDB配置存在主.env文件里，可以提前在项目配置中声明自定义变量，让CLI识别为需要保留的内容：

• 打开项目根目录的shopify.app.toml文件，在文件中添加自定义配置声明：

  [custom]
  # 按你需要的Mongo配置项逐个声明，值留空即可
  mongodb_uri = ""
  mongodb_db_name = ""
  

• 第一次运行shopify serve时，CLI会自动在.env文件里生成对应的空配置字段，你只需要把真实的MongoDB连接信息填进去
• 后续再重启服务时，CLI会把这些声明过的自定义变量判定为项目合法配置，不会在重写.env时把它们删掉
• 这种方式的好处是所有项目配置都集中在根目录统一管理，不会因为拆分文件导致配置遗漏。

其他替代实现方案 #

• 本地开发场景：启动shopify serve之前，先在当前终端会话中临时导出MongoDB相关的环境变量，比如Mac/Linux终端执行export MONGODB_URI="你的Mongo连接串"，Windows PowerShell执行$env:MONGODB_URI="你的Mongo连接串"，再启动服务时你的应用可以直接读取到这些全局环境变量，完全不依赖本地.env文件
• 生产部署场景：直接把MongoDB配置配置到托管平台（比如应用服务器、Serverless平台）的环境变量管理面板中，本地开发仅按需补全配置，不需要和Shopify CLI的.env文件维护逻辑产生冲突

注意：不要通过给根目录.env文件加只读权限的方式阻止CLI重写，这种操作会触发Shopify CLI的配置写入报错，导致应用同步、热更新功能异常。

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