You need to enable JavaScript to run this app. React+Firebase项目调用process.env.API_KEY提示未定义该如何排查?
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 06:45:02