鸿蒙NEXT-HMRouter，在使用router后无法跳转问题解决

原创

用户11718959

修改于 2025-07-03 20:52:58

3362

作者使用三方库@HMRouter，用来搭建鸿蒙的三层架构（基础特性层，产品定制层，公共能力层）完成App，跨包跳转的时候，在登录页进入首页的时候遇到了一个奇怪的Bug，在我们使用router.push()跳转后，然后再使用HMRouter突然就无法跳转页面了，那么我们该怎么办呢？，现在将该bug的解决方法分享出来。

错误示例代码如下所示：

import { router } from '@kit.ArkUI';

@Entry
@ComponentV2
struct LoginPage {
  @State message: string = 'Hello World';
  aboutToAppear(): void {
    console.log('LifeCircle创建')
  }
  onDidBuild(): void {
    console.log('LifeCircle组件构建完成')
  }
  onPageShow(): void {
    console.log('页面-PageShow')
  }
  onPageHide(): void {
    console.log('页面-Page隐藏')
  }
  build() {
    Column(){
        /*登录页面代码省略**/
    }
    .onVisibleAreaChange([1.0],()=>{
        /**省略登录校验过程**/
      router.replaceUrl({url:'pages/Index'})
    })
  }
}

作者为了方便，当已经登录过了之后就直接在onVisibleAreaChange中直接登录跳转到首页去了，到了首页发现，使用HMRouter无法跳转到其他页面了，点击跳转按钮也没有任何反应。

分析错误原因:

onVisibleAreaChange 是高频触发的回调，若在此处直接跳转，可能因页面未完全初始化导致路由状态异常。(页面生命周期冲突)

解决方案：

避免在 onVisibleAreaChange 中直接跳转，改用显式触发（如按钮点击）或页面生命周期回调

例如下面示例代码所示:

import { router } from '@kit.ArkUI';

@Entry
@Component
struct LoginPage{
  @State message: string = 'Hello World';
  aboutToAppear(): void {
    router.replaceUrl({url:'pages/Index'})
    console.log('LifeCircle创建')
  }
  onDidBuild(): void {
    console.log('LifeCircle组件构建完成')
  }
  onPageShow(): void {
    console.log('页面-PageShow')
  }
  onPageHide(): void {
    console.log('页面-Page隐藏')
  }
  build() {
    Column(){
    }
  }
}