You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Github Pages无法访问SvelteKit构建产物的_app目录文件求助

解决Github Pages上SvelteKit静态构建产物_app目录404问题

针对你遇到的问题,给你几个实际可行的排查和解决步骤:

  • 检查SvelteKit的base路径配置
    因为你的站点部署在项目子路径下,必须在svelte.config.js里设置正确的base路径:

    import adapter from '@sveltejs/adapter-static';
    
    export default {
      kit: {
        adapter: adapter(),
        paths: {
          base: '/carta-md/'
        }
      }
    };
    

    配置后重新构建项目,确保静态资源的引用路径都带上这个base前缀,否则会从根域名查找资源,自然返回404。

  • 确认构建产物的目录结构
    查看你的gh-pages分支,确保_app目录直接在分支根目录下,而非嵌套在build或其他子目录里。如果构建命令输出到了build文件夹,需要把build内的所有内容直接推到gh-pages分支的根,而非上传整个build文件夹。

  • 核对Github Pages部署设置
    进入仓库的Settings -> Pages页面,确认Source选项选择的是gh-pages分支,且文件夹选择的是/(root)。如果选成其他目录,Github Pages会找不到_app下的资源。

  • 强制触发重新部署
    Github Pages有时会存在缓存问题,即使文件已更新,旧缓存仍会生效。可以在Pages设置页面,无需修改任何选项,直接点击"Save"按钮,强制触发一次重新部署以清除缓存。

  • 检查文件访问权限
    确保gh-pages分支里的_app目录及所有文件都是公开可访问的(Github Pages默认公开,但如果仓库是私有仓库,需确认Pages权限设置为公开)。

内容的提问来源于stack exchange,提问作者Astro Bear

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.15 15:42:07