SvelteKit集成AWS Amplify构建后报Amplify.configure is not a function错误

云原生阿岚

2026-10-5

解决方案

根因说明

你遇到的两个问题本质都和SvelteKit默认启用的服务端渲染（SSR）逻辑有关：

打包阶段Vite报错是因为aws-sdk相关依赖在服务端构建流程中会加载Node端专属的身份凭证模块，Vite没有自动替换浏览器专属的运行时配置导致报错
Amplify.configure is not a function报错是因为你的Amplify初始化代码被服务端渲染流程加载执行，Node端的@aws-amplify/core模块导出结构和浏览器端不一致，不存在对应方法。

操作步骤

调整svelte.config.cjs配置，保留原有别名的同时补充服务端构建排除规则，完整配置参考：

// svelte.config.cjs
module.exports = {
  kit: {
    // 保留你原有其他配置项
    vite: {
      resolve: {
        alias: {
          "./runtimeConfig": "./runtimeConfig.browser"
        }
      },
      ssr: {
        // 标记所有aws-amplify相关包不在服务端构建阶段处理
        noExternal: [/^@aws-amplify\/.*/, /^aws-amplify$/]
      }
    }
  }
}

调整Amplify初始化逻辑，确保仅在浏览器端执行，修改原有代码如下：

import { browser } from '$app/env';
import awsconfig from "../aws-exports";

// 仅在浏览器环境下导入和初始化Amplify
if (browser) {
  import('@aws-amplify/core').then(({ default: Amplify }) => {
    Amplify.configure(awsconfig);
  });
  // 后续使用Auth、其他Amplify模块的逻辑也需放在browser判断分支内，或在组件的onMount生命周期中执行
}