鸿蒙路由带参数

平时天天用，面试记不得！！！在鸿蒙（HarmonyOS）应用开发中，路由回退时携带参数是实现页面间数据回传的关键功能。以下是具体实现方法及注意事项，基于官方Router模块和开发实践整理：

🔄 一、基础参数回传方法

通过 router.back() 返回时，可在配置对象中定义 params 属性传递参数：

php 复制代码

router.back({
  url: 'pages/HomePage', // 目标页面路径（需在页面栈中存在）
  params: { 
    updated: true, 
    data: JSON.stringify({ id: 1001, status: 'success' }) 
  }
});

参数类型 ：支持 string | number | boolean | object，对象需用 JSON.stringify() 序列化。
目标页限制 ：url 指定的页面必须在当前页面栈中，否则无法跳转。

📥 二、目标页面接收参数

在返回的目标页面（如 HomePage）中，需在 **onPageShow() 生命周期** 中通过 router.getParams() 获取参数：

csharp 复制代码

onPageShow() {
  const params = router.getParams();
  if (params) {
    try {
      const updated = params['updated']; // 布尔值
      const data = JSON.parse(params['data'] as string); // 反序列化对象
    } catch (error) {
      console.error('参数解析失败', error);
    }
  }
}

关键点：

避免在 onInit() 或 aboutToAppear() 中获取参数，因页面栈未就绪可能失败。
使用 try-catch 处理格式错误或缺失参数。

⚙️ 三、参数传递的两种方式

URL参数

适用于简单数据（如ID）：
css 复制代码
```
router.back({ url: 'pages/HomePage?id=123' });
```
- 通过 router.getParams()['id'] 获取。

对象参数

适合复杂数据（需序列化）：

php 复制代码

router.back({
  url: 'pages/HomePage',
  params: { user: JSON.stringify({ name: '张三', vip: true }) }
});

🛡️ 四、参数处理的最佳实践

数据大小
- 超过 1MB 的数据避免使用路由传递，改用状态管理（如 AppStorage）。
安全性
- 禁止传递密码、Token等敏感信息。
类型校验
- 接收参数后验证类型，避免类型错误导致崩溃：
  csharp 复制代码
```
const id = Number(params['id']) || 0; // 确保为数字
```

⏪ 五、多层页面回退问题

当前 router.back() 不支持直接返回栈底或多层跳转。若需从页面D返回至A：

循环调用 router.back() 多次（出现中间页面B、C）。
替代方案：
- 通过 params 携带标记，在A页面初始化时重新加载数据：
  php 复制代码
```
// D页面调用
router.back({ url: 'pages/A', params: { resetData: true } });
```
- 使用全局状态管理同步数据，绕过页面栈限制。

🚧 六、高级功能扩展

结合路由守卫（Router Hooks）实现权限控制：

vbnet 复制代码

// 全局守卫检查参数有效性
router.addBeforeHook((to, from, next) => {
  if (to.url === 'pages/ProfilePage' && !validateParams(to.params)) {
    next(false); // 阻止跳转
  } else {
    next();
  }
});

💎 总结

鸿蒙路由回退传参的核心流程：

序列化参数 → router.back() 携带 → 目标页 onPageShow() 安全解析。

优先使用 JSON 处理对象，避免直接传递大对象。
多层回退需结合状态管理或参数标记实现。
始终在生命周期钩子中处理参数，确保页面栈就绪。