SvelteKit 2部署至Vercel失败求助

以下是针对本地运行正常但Vercel部署失败问题的排查与解决步骤：

• 适配Node.js版本
  SvelteKit 2要求Node.js版本≥18.17.0，Vercel默认环境可能版本过低。你可以：

  • 在项目根目录新建.nvmrc文件，写入18.17.0或更高稳定版（如20.x）
  • 或者在Vercel项目后台的「Build & Development Settings」中手动指定Node版本

• 确保Vercel适配器配置正确
  安装最新版的Vercel适配器：

  npm install @sveltejs/adapter-vercel@latest
  

  并在svelte.config.js中配置：

  import adapter from '@sveltejs/adapter-vercel';
  import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
  
  export default {
    preprocess: vitePreprocess(),
    kit: {
      adapter: adapter()
    }
  };
  

• 清理Vercel构建缓存
  在Vercel的部署页面，选择「重新部署」并勾选「Clear build cache and redeploy」，避免旧缓存引发的依赖冲突。

• 检查构建脚本
  确认package.json中的build脚本为Vite命令（SvelteKit 2已弃用旧的svelte-kit build）：

  "scripts": {
    "build": "vite build",
    "dev": "vite dev",
    "preview": "vite preview"
  }
  

• 排查依赖冲突
  删除node_modules、package-lock.json（或yarn.lock），重新执行npm install，确保所有核心依赖（svelte、@sveltejs/kit、vite）版本兼容SvelteKit 2。

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