为何React Router v6不推荐使用HashRouter？

主要弊端 #

• SEO表现极差：搜索引擎爬虫一般不会解析URL哈希（#后内容），路由对应的页面内容无法被正常收录，直接拉低网站搜索排名。
• URL语义化缺失：哈希路由的URL结构（如xxx.com/#/user）不符合标准URL的语义规范，既不专业，也不利于用户快速识别当前页面位置，影响用户体验。
• 服务器端渲染(SSR)难以适配：哈希部分不会随请求发送到服务器，SSR场景下服务器无法根据哈希值返回对应页面内容，只能返回默认入口页，完全丧失SSR的性能和SEO优势。
• 第三方工具/API兼容性问题：
  • 依赖URL路径的分析工具（如统计分析、深度链接服务）可能无法正确识别哈希路由的路径，导致数据统计错误或跳转失效。
  • 部分OAuth认证、第三方登录服务的回调URL配置不支持带哈希的路径，会直接导致认证流程失败。

是否会破坏API？ #

HashRouter不会直接破坏React Router的核心API，但它基于哈希变化监听路由的机制，和BrowserRouter依赖的HTML5 History API有本质区别。如果代码中依赖了BrowserRouter特有的行为（比如useNavigation的部分特性、navigate方法的replace逻辑在哈希路由下的表现差异），可能会出现不符合预期的结果，但这属于路由机制差异导致的行为不一致，而非API被破坏。

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