SvelteKit部署到Vercel时环境变量报错问题求助

核心原因 #

本地.env文件不会被推送到Git仓库，Vercel部署时无法读取本地的私有环境变量，导致Rollup找不到PRIVATE_API_KEY的导出。

解决步骤 #

1. 在Vercel仪表盘添加私有环境变量 #

• 登录Vercel进入项目页面，切换到「Settings」→「Environment Variables」
• 点击「Add」，输入变量名PRIVATE_API_KEY，值填写你的密钥123456789
• 根据部署需求勾选「Preview」和「Production」环境，保存后触发重新部署

2. 确认本地.env文件已被Git忽略 #

• 检查项目根目录的.gitignore文件，确保包含.env相关规则，避免敏感信息泄露：

  # SvelteKit环境文件
  .env
  .env.*
  !.env.example
  

3. 验证SvelteKit适配器配置 #

• 确保项目使用官方Vercel适配器@sveltejs/adapter-vercel，在svelte.config.js中配置正确：

  import adapter from '@sveltejs/adapter-vercel';
  
  export default {
    kit: {
      adapter: adapter()
    }
  };
  

• 若适配器版本过旧，执行更新命令：

  npm install @sveltejs/adapter-vercel@latest
  

4. 检查变量命名与拼写 #

• 确认私有变量严格以PRIVATE_开头，大小写、下划线完全匹配，避免出现private_api_key这类错误命名

5. 重新部署测试 #

完成上述配置后，在Vercel仪表盘手动触发重新部署，或推送新Git提交触发部署，错误即可解决。

内容的提问来源于stack exchange，提问作者jonthornham