[Bug]: 使用约定式路由部署至Github pages时，刷新页面会404

[zzmelody]

版本信息

System:
    OS: Windows 10 10.0.19045
    CPU: (12) x64 Intel(R) Core(TM) i7-8700 CPU @ 3.20GHz    
    Memory: 9.09 GB / 31.83 GB
  Browsers:
    Edge: Spartan (44.19041.3636.0), Chromium (125.0.2535.92)
    Internet Explorer: 11.0.19041.3636
  npmPackages:
    @modern-js/app-tools: 2.53.0 => 2.53.0
    @modern-js/eslint-config: 2.53.0 => 2.53.0
    @modern-js/plugin-ssg: 2.53.0 => 2.53.0
    @modern-js/runtime: 2.53.0 => 2.53.0
    @modern-js/tsconfig: 2.53.0 => 2.53.0

问题详情

项目使用约定式路由，通过 assetPrefix参数修改资源路径至 github pages对应项目路径，可以打开页面，并正确跳转路由；但是跳转路由后刷新页面时会404，提示找不到页面，以下是 modern.config.ts内容（下方的 dist在打包时会替换为 项目名称）：

import { appTools, defineConfig } from '@modern-js/app-tools';

// https://modernjs.dev/en/configure/app/usage
export default defineConfig({
    output: {
        distPath: {
            html: '',
        },
        assetPrefix: '/../dist',
    },
    html: {
        disableHtmlFolder: true,
    },
    source: {
        mainEntryName: 'index',
    },
    server: {
        baseUrl: '/dist',
    },
    runtime: {
        router: {
            basename: '/dist',
        },
        state: true,
    },
    plugins: [
        appTools({
            bundler: 'experimental-rspack',
        }),
    ],
});

复现链接

-

复现步骤

1. 使用modernjs 创建一个webapp项目，使用上方我的 modern.config.ts配置
2. 使用约定式路由创建两个页面， / , /a
3. 部署至github pages 或者gitlab pages
4. 打开页面，跳转至 a 路由，刷新页面

[zllkjc]

github page 是不是默认情况下不支持 SPA 的

[zzmelody]

github page 是不是默认情况下不支持 SPA 的

好的，谢谢，我试试用404.html的方式来实现下看看

[zzmelody]

结合这篇文章解决了 GitHub Pages 如何实现 SPA； 不过在modernjs里面，index.html（入口组件中）中要用 useNavigate来进行跳转，不能用 history.replaceState