React+Firebase项目调用process.env.API_KEY提示未定义该如何排查?
环境变量读取失败的常见原因
- 变量命名不符合Create React App(CRA)规则:CRA默认只会加载以
REACT_APP_为前缀的自定义环境变量,无此前缀的变量会被自动过滤,你需要将.env中的变量修改为REACT_APP_API_KEY=somekey,调用时使用process.env.REACT_APP_API_KEY即可。 - .env文件存放位置错误:需确保.env文件放在项目根目录,和package.json文件同级,不能存放在src、public等子目录下。
- 未重启开发服务:修改.env文件内容后,必须重启本地开发服务器才会加载新的环境变量,热更新不会同步.env的变更。
- 自定义脚手架未配置环境变量加载:如果你没有使用CRA,而是自己搭建的React项目,需要手动在webpack等构建工具配置中集成dotenv来加载.env文件,同时通过DefinePlugin将process.env变量注入到前端运行环境中。
- 生产环境未配置对应变量:如果是打包部署到线上时出现该问题,需要在部署平台的环境变量配置项中添加对应变量,或是打包前确认.env文件存在于项目根目录。
package.json配置说明
使用官方CRA创建的项目无需在package.json中做额外配置,CRA内置了dotenv支持,只要变量命名符合规则即可正常读取。自定义脚手架项目也不需要修改package.json,调整构建工具的环境变量加载配置即可。
内容的提问来源于stack exchange,提问作者npkp
相关产品推荐
相关产品推荐

