SvelteKit在Google Cloud Shell环境构建失败预览404求助

结合你的场景（资深前端、首次用SvelteKit、Cloud Shell开发+Cloud Run部署），以下是针对性的排查方向：

1. 路由配置缺失 #

SvelteKit采用文件系统路由，根路由必须存在src/routes/+page.svelte文件。如果这个文件丢失或路径错误，访问/必然返回404，且构建产物不会生成根路径对应的HTML。

检查src/routes目录结构：

src/
└── routes/
    └── +page.svelte  # 必须存在这个文件作为根路由

2. SvelteKit适配器配置错误 #

要部署到Cloud Run，需使用适配Node.js环境的适配器，默认的adapter-auto可能在Cloud Shell环境下自动检测失效，导致产物仅生成客户端JS，无服务端/静态HTML。

修复步骤： #

• 安装Node适配器：

  npm install @sveltejs/adapter-node --save-dev
  

• 修改svelte.config.js：

  import adapter from '@sveltejs/adapter-node';
  import { vitePreprocess } from '@sveltejs/kit/vite';
  
  /** @type {import('@sveltejs/kit').Config} */
  const config = {
    preprocess: vitePreprocess(),
    kit: {
      adapter: adapter()
    }
  };
  
  export default config;
  

• 删除.svelte-kit和build文件夹，重新执行npm run build。

3. 环境与依赖问题 #

Node.js版本不兼容 #

SvelteKit要求Node.js版本≥18.x，Cloud Shell默认Node版本可能偏低。检查并升级：

node -v  # 查看当前版本
nvm install 18  # 安装v18版本
nvm use 18      # 切换到v18

文件权限问题 #

Cloud Shell的文件系统权限可能导致构建产物生成不完整，修复权限：

sudo chown -R $USER:$USER .svelte-kit build

4. 构建命令与预览配置 #

• 确认package.json中的scripts为标准配置：

  "scripts": {
    "dev": "vite dev",
    "build": "vite build",
    "preview": "vite preview --host 0.0.0.0"
  }
  

  预览时加上--host 0.0.0.0确保Cloud Shell的Web预览能访问到服务（虽然你终端报404是路由问题，但这个配置能避免访问不到服务的情况）。

快速验证流程 #

1. 确认src/routes/+page.svelte存在且内容正常
2. 安装并配置adapter-node
3. 清理旧产物：rm -rf .svelte-kit build
4. 重新安装依赖：npm install
5. 重新构建：npm run build
6. 启动预览：npm run preview --host 0.0.0.0

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