Vite+React项目部署Netlify时环境变量使用问题求助
Vite+React部署Netlify环境变量不生效的解决办法
- 强制重新触发构建:Netlify配置环境变量后,旧的构建缓存不会自动加载新变量。到站点的Deploys页面,点击「Trigger deploy」→「Deploy site」,重新执行构建流程。
- 核对变量名大小写:确保Netlify控制面板里的变量名和代码里的完全一致,比如
VITE_API_KEY必须大小写完全匹配,Vite对变量名大小写敏感。 - 检查构建日志确认变量注入:在Netlify的构建日志中搜索你的环境变量名(比如
VITE_API_KEY),确认构建过程中变量已被正确读取。也可以在组件中添加console.log(import.meta.env),部署后打开浏览器控制台查看变量是否存在。 - 弃用无效的变量写法:
%VITE_API_GOOGLE%是旧工具(如Vue CLI)的语法,Vite不支持这种写法,直接删除即可,统一使用import.meta.env.VITE_xxx格式。 - 确认构建命令正确性:检查项目package.json的
scripts里,build命令是否为vite build,Netlify默认执行npm run build,必须确保该命令对应Vite的构建逻辑。
内容的提问来源于stack exchange,提问作者lucaslangsch
相关产品推荐
相关产品推荐

