SvelteKit导入函数报‘x is not a function’错误排查

安全阿岳

2026-7-21

问题分析与解决方案

你的问题大概率是循环依赖或者SSR模块加载时机差异导致的，以下是具体原因和解决办法：

可能的原因

循环依赖：如果userController.js和userGroupController.js（或它们间接依赖的模块）存在互相导入的情况，会导致SSR时模块加载顺序混乱。当userGroupController尝试调用deleteUserCache时，userController的导出还未完全初始化，因此出现"不是函数"的错误。加判断后，代码会在后续时机重试调用，此时模块已加载完成，所以能正常执行。
SSR异步模块加载：如果userController中存在顶层await或其他异步初始化逻辑，模块会被标记为异步模块。在SSR同步加载阶段无法获取到完整的导出内容，导致导入的deleteUserCache暂时为undefined。

解决办法

1. 排查并消除循环依赖

检查以下内容：

userController.js是否导入了userGroupController.js中的任何内容
两个文件是否共同依赖某个第三方模块，而该模块又反向依赖了其中一个文件
找到循环依赖后，重构代码拆分公共逻辑到独立模块，或调整导入方式避免互相引用。

2. 使用动态导入替代静态导入

在调用函数的位置改用异步动态导入，确保模块完全加载后再执行函数：

export const reloadUserGroupArrayAccess = async () => {
    const { deleteUserCache } = await import('$lib/controller/userController');
    deleteUserCache();
};

3. 移除模块顶层异步逻辑

如果userController中有顶层await或异步初始化代码，把这些逻辑移到函数内部执行，避免模块本身成为异步模块：

// 错误写法（顶层await）
let userCache = await fetchUserCache();

// 正确写法
let userCache = {};

export const initUserCache = async () => {
    userCache = await fetchUserCache();
};