close
  • 简体中文
  • server.htmlFallback

    • 类型: false | 'index'
    • 默认值: 'index'

    是否启用 HTML 页面回退功能。

    默认行为

    在默认配置下,如果请求同时满足以下条件,但未找到对应资源时,将自动回退到 index.html:

    • 请求方法为 GET 或 HEAD
    • 请求头的 Accept 字段包含 text/html*/*
    rsbuild.config.ts
    export default {
      server: {
        htmlFallback: 'index',
      },
    };

    禁用

    如果不想启用 HTML 页面回退功能,可以将 server.htmlFallback 设置为 false

    rsbuild.config.ts
    export default {
      server: {
        htmlFallback: false,
      },
    };

    自定义

    如果 server.htmlFallback 无法满足你的需求,可以通过 server.historyApiFallback 进行更灵活的设置。