You need to enable JavaScript to run this app. MERN栈React应用部署Heroku后同页锚点滚动失效问题
优惠活动
大模型
产品
解决方案
定价
更多

MERN栈React应用部署Heroku后同页锚点滚动失效问题

问题根因

你遇到的问题本质是HashRouter占用了URL的#位,导致同页锚点的双#结构(比如/#/#about)无法被浏览器默认识别为锚点跳转,本地正常是因为开发环境的热重载/路径解析逻辑和生产打包后有差异,不属于后端配置问题,你的server.js配置完全符合HashRouter的部署要求。
另外先修正你代码里的笔误:Teams导航的hred="#teams"拼写错误,要改成href="#teams"。

可直接落地的解决方案

方案1:替换路由Link为原生滚动逻辑(最稳妥,不会触发路由重渲染)

react-router的Link组件本身是做路由跳转的,不适合用来处理同页锚点,直接把导航栏里的锚点跳转全部替换为原生标签加自定义滚动逻辑即可:

// Navbar组件内修改
return (
    <div className="links">
        <div className="innerLinks">
            <a 
              href="#about" 
              onClick={(e) => {
                e.preventDefault()
                document.getElementById('about')?.scrollIntoView({behavior: 'smooth'})
              }}
            >About</a>
            <a 
              href="#teams" 
              onClick={(e) => {
                e.preventDefault()
                document.getElementById('teams')?.scrollIntoView({behavior: 'smooth'})
              }}
            >Teams</a>
            <a 
              href="#Business" 
              onClick={(e) => {
                e.preventDefault()
                document.getElementById('Business')?.scrollIntoView({behavior: 'smooth'})
              }}
            >Businesses</a>
            <a 
              href="#Indivisual" 
              onClick={(e) => {
                e.preventDefault()
                document.getElementById('Indivisual')?.scrollIntoView({behavior: 'smooth'})
              }}
            >Indivisuals</a>
            <a 
              href="#Investors" 
              onClick={(e) => {
                e.preventDefault()
                document.getElementById('Investors')?.scrollIntoView({behavior: 'smooth'})
              }}
            >Investors</a>
        </div>
        <a 
          href="#intern" 
          onClick={(e) => {
            e.preventDefault()
            document.getElementById('intern')?.scrollIntoView({behavior: 'smooth'})
          }}
        >
        <Button
            color="primary"
            className="button animate__animated animate__pulse animate__infinite"
        >
            Join Us
        </Button>
        </a>
    </div>
 );

如果需要跳转后URL同步显示锚点,在scrollIntoView后加一行window.location.hash = e.target.getAttribute('href').replace('#','')即可。

方案2:全局监听哈希变化适配跨页面锚点

如果存在从其他页面跳回首页锚点的需求,可以在首页路由的根组件加监听逻辑:

// 首页对应的组件(或者App.js内的首页Route包裹的组件)
import { useLocation } from 'react-router-dom'

export default function Home() {
  const location = useLocation()
  // 监听路径/哈希变化,自动滚动到对应锚点
  useEffect(() => {
    const hash = window.location.hash
    if(hash) {
      const targetId = hash.slice(1)
      // 兼容生产环境组件渲染延迟,加个短延迟重试
      const tryScroll = () => {
        const target = document.getElementById(targetId)
        if(target) {
          target.scrollIntoView({behavior: 'smooth'})
        } else {
          setTimeout(tryScroll, 100)
        }
      }
      tryScroll()
    }
  }, [location])

  // 其余组件逻辑...
}

额外校验点

部署前确认所有锚点对应的div的id和导航里的锚点完全一致,大小写也要匹配,生产环境不会像本地开发环境一样宽松解析大小写。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.17 16:36:05