You need to enable JavaScript to run this app. 如何在已部署于AWS Amplify的React应用中使用环境变量
优惠活动
大模型
产品
解决方案
定价
更多

如何在已部署于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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.05 06:06:03