Blazor WASM调用JS函数报错：找不到downloadFileFromStream

可能原因 #

• JS函数加载顺序问题：如果downloadFileFromStream函数的定义放在Blazor初始化脚本之后，Blazor组件初始化时该函数还未被注册到全局window对象，导致调用失败。
• 浏览器缓存干扰：发布后浏览器缓存了旧的静态资源（如index.html），新窗口加载时实际使用的是未包含该函数的缓存版本，硬刷新会强制拉取最新资源，所以能正常工作。
• 打包工具的作用域处理：项目使用的打包工具（如Vite、Webpack）可能将JS函数封装到局部作用域，没有暴露到全局window对象上。

解决办法 #

1. 调整JS函数的加载位置 #

确保downloadFileFromStream函数的定义放在Blazor初始化脚本之前，示例代码：

<script>
window.downloadFileFromStream = async (fileName, contentStreamReference) => {
    const arrayBuffer = await contentStreamReference.arrayBuffer();
    const blob = new Blob([arrayBuffer]);
    const url = URL.createObjectURL(blob);
    const anchorElement = document.createElement('a');
    anchorElement.href = url;
    anchorElement.download = fileName;
    anchorElement.click();
    URL.revokeObjectURL(url);
}
</script>
<!-- Blazor初始化脚本放在后面 -->
<script src="_framework/blazor.webassembly.js"></script>

2. 强制浏览器缓存失效 #

• 发布时给自定义JS资源添加版本哈希，比如custom.js?v=20240520，每次发布更新版本号，避免浏览器缓存旧资源。
• 在index.html的<head>中添加缓存控制meta标签，限制index.html的缓存时长：

<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate" />
<meta http-equiv="Pragma" content="no-cache" />
<meta http-equiv="Expires" content="0" />

3. 确保函数暴露到全局作用域 #

如果使用ES模块语法，不要用局部函数，明确挂载到window对象：

window.downloadFileFromStream = async function(fileName, contentStreamReference) {
    // 函数逻辑
};

4. 延迟JS函数调用时机 #

在Blazor组件中，确保JS运行时初始化完成后再调用函数，可通过生命周期方法验证：

protected override async Task OnAfterRenderAsync(bool firstRender)
{
    if (firstRender)
    {
        // 提前验证函数是否存在
        var functionExists = await JS.InvokeAsync<bool>("typeof downloadFileFromStream !== 'undefined'");
        if (!functionExists)
        {
            // 可添加日志或提示逻辑
        }
    }
}

public async Task DownloadAsync()
{
    await JS.InvokeVoidAsync("downloadFileFromStream", fileName, new DotNetStreamReference(stream));
}

5. 验证发布包与服务器资源 #

• 发布后清理服务器端旧的静态资源，确保发布包中包含最新的index.html和JS代码。
• 使用浏览器开发者工具（F12）的网络面板，查看新窗口加载时index.html的状态码，确认是从服务器拉取的最新版本（状态码200，而非304）。

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