SvelteKit哈希函数报错TypeError: value must be a string or TypedArray求助

核心错误原因 #

你遇到的TypeError: value must be a string or TypedArray错误，根源是**+layout.ts中的load函数没有返回合法对象**。SvelteKit要求所有load函数必须返回一个对象（或Promise<对象>），如果函数无return语句，async函数会默认返回undefined，而内部哈希函数在处理缓存逻辑时，无法对undefined进行哈希计算，从而抛出该错误。

另外代码中还有几个潜在问题可能引发其他异常：

• fetch路径格式可能与你的端点定义不匹配
• 未处理user.settings.favorites[i]为undefined的情况
• fetch参数类型用any存在类型风险

解决步骤 #

1. 修复load函数的返回值 #

确保load函数始终返回对象，哪怕是空对象。如果需要将createFavorites的结果传递给组件，可返回包含该数据的对象：

// +layout.ts
export const load = (async ({ data, fetch }) => {
    let favLinks: Link[] = [];
    if (data && data.user) {
        favLinks = await createFavorites(data.user, fetch);
    }
    // 必须返回对象，这是解决哈希错误的关键
    return { favLinks };
});

如果不需要传递数据，至少返回空对象：

export const load = (async ({ data, fetch }) => {
    if (data && data.user) {
        await createFavorites(data.user, fetch);
    }
    return {};
});

2. 验证fetch路径合法性 #

根据你的端点类型调整fetch路径：

• 若调用Server Action（定义在links/+page.server.ts中的action函数），路径格式'/links?/getLink'是正确的
• 若调用API端点（定义在links/+server.ts中的POST方法），路径应改为'/links'，无需?/getLink后缀

3. 处理可能的undefined值 #

避免对undefined进行JSON.stringify，添加前置判断：

// 在createFavorites函数的循环内
const favoriteId = user.settings.favorites[i];
if (!favoriteId) {
    if (dev) console.warn(`Skipping undefined favorite ID at index ${i}`);
    continue;
}
formData.append('id', JSON.stringify(favoriteId));

4. 优化类型定义 #

替换fetch: any为SvelteKit提供的Fetch类型，避免类型错误：

import type { Fetch } from '@sveltejs/kit';

async function createFavorites(user: User, fetch: Fetch) {
    // ... 函数内容
}

验证效果 #

修改后重新运行应用，调用createFavorites时的哈希错误应会消失。若仍有问题，检查deserialize函数是否返回了无法序列化的内容（如循环引用、函数等），这类值也可能导致SvelteKit哈希逻辑出错。

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