SvelteKit部署后访问static文件夹下zip文件返回404如何解决？

正确配置方案 #

• 文件存放位置：直接放在项目根目录的static文件夹下，无需额外嵌套目录
• 请求路径写法：使用/开头的绝对路径，代码示例如下：

const res = await fetch("/makeup.zip")

问题原因说明 #

SvelteKit 本地开发环境下 Vite 会临时保留static目录的路由映射用于调试，但生产构建时会将static目录下的所有文件直接复制到构建产物的根目录，不会保留static这一层路径，因此部署后/static/makeup.zip路径不存在，返回404。

若按上述配置仍返回404的排查点 #

• 禁止使用相对路径：不要写./static/makeup.zip、makeup.zip这类相对路径，相对路径会和当前页面路由拼接，导致请求地址错误
• 检查SvelteKit配置：确认svelte.config.js中使用的适配器没有过滤.zip格式的静态资源，部分适配器默认会忽略不常见的资源后缀，需要手动在配置中添加允许的静态资源后缀规则
• 校验本地构建产物：执行npm run build后查看构建输出目录（默认路径为.svelte-kit/output/client，不同适配器路径略有差异）根目录下是否存在makeup.zip，如果不存在说明构建环节被过滤
• 检查部署平台规则：部分静态资源托管平台默认会拦截压缩包格式的访问请求，需要在平台的静态资源配置中手动允许.zip后缀的资源访问

其他同类框架参考（Gatsby/Nuxt通用规则） #

这类SSR/SSG框架的静态资源管理逻辑基本一致：

• 静态资源统一放在框架约定的专用静态目录中（Gatsby为static、Nuxt2为static、Nuxt3为public）
• 生产构建后目录内的文件会直接输出到构建产物根目录，请求路径直接写/文件名.后缀即可，不需要拼接静态目录本身的路径

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