Vercel免费部署时AWS S3环境变量被保留，如何正确设置？
2026-8-14
解决Vercel部署时AWS S3环境变量保留名称报错问题
- 排查冲突变量：你使用的AWS S3相关环境变量名（比如
AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）属于Vercel的保留变量范畴，因此无法直接使用。 - 自定义变量名称：给AWS S3相关变量重命名，避开保留名称。比如：
- 将
AWS_ACCESS_KEY_ID改为MY_S3_ACCESS_KEY - 将
AWS_SECRET_ACCESS_KEY改为MY_S3_SECRET_KEY - 将
AWS_REGION改为MY_S3_REGION - 将
S3_BUCKET_NAME改为MY_S3_BUCKET
- 将
- 适配代码中的变量引用：在项目代码里，把所有读取原AWS变量的地方替换为自定义的变量名。比如把
process.env.AWS_ACCESS_KEY_ID替换成process.env.MY_S3_ACCESS_KEY，确保代码能正确读取新的环境变量。 - 重新设置并部署：在Vercel控制台删除原来报错的保留名称变量，添加自定义后的变量，然后重新触发部署流程。
内容的提问来源于stack exchange，提问作者Sebi
相关产品推荐
相关产品推荐
