如何在已部署于AWS Amplify的React应用中使用环境变量
在 AWS Amplify 部署的 React 应用中读取平台侧配置环境变量的操作方法
首先要明确Create React App 的强制规则:只有以REACT_APP_为前缀的环境变量,才会在构建阶段被注入到前端可访问的JS运行时环境中,不符合这个命名规范的变量,无论在Amplify平台上怎么配置,代码里都读不到。
具体操作和注意事项如下:
- 核对Amplify侧的变量命名
你在Amplify控制台配置的、需要给前端JS用的环境变量,必须按照上述规范命名,比如配置后端接口地址就命名为REACT_APP_API_ENDPOINT,不要使用没有前缀的变量名,比如直接写API_ENDPOINT是无法被前端代码获取的。 - 代码中的读取写法
所有符合前缀规则的变量,直接通过全局process.env对象取值即可,示例:
常见接入场景示例:// 直接在业务代码中读取 const apiBaseUrl = process.env.REACT_APP_API_ENDPOINT;// 封装请求实例时直接使用变量值 import axios from 'axios'; const httpClient = axios.create({ baseURL: process.env.REACT_APP_API_ENDPOINT, timeout: 10000 }); - 常见踩坑提醒
- 修改Amplify侧的环境变量后,必须重新触发应用的完整构建部署才会生效:环境变量是在构建阶段被静态替换、打包进前端静态JS文件的,并不是运行时动态从AWS服务拉取的,不重新构建的话,已经上线的代码里不会更新变量值。
- 不要把高敏感的保密值(如数据库密码、服务端私钥)配置成带
REACT_APP_前缀的变量:这类变量最终会被打包到公开可访问的前端静态资源中,任何用户打开浏览器开发者工具都能直接看到,敏感值应该通过Amplify后端资源配置,由服务端接口返回给前端,不能直接暴露在前端代码里。 - 如果你的React项目是用Vite构建的,前缀规则要换成
VITE_,读取方式也要换成import.meta.env.VITE_XXX,不要和CRA的读取逻辑混淆。
内容的提问来源于stack exchange,提问作者ZoeDeep
相关产品推荐
相关产品推荐

