AutoRoute库中深度链接重复调用问题的分析与解决

问题背景

在使用AutoRoute库实现深度链接功能时，开发者遇到了一个典型问题：当用户点击深度链接时，目标页面会被多次重复调用。具体表现为第一次点击正常显示页面，第二次点击显示两次，第三次点击显示三次，以此类推。这个问题在Android和iOS平台上都会出现。

问题复现场景

开发者的路由配置如下：

1. 使用/business/:id路径作为深度链接入口
2. SplashRoute作为初始路由接收ID参数
3. 通过程序化导航将BusinessRoute推入堆栈
4. 设置了rebuildStackOnDeepLink: true

根本原因分析

经过深入排查，发现问题的核心在于两个方面：

1. 路由历史保留机制：AutoRoute默认会保留路由历史记录(keepHistory: true)，这会导致每次导航时旧路由不会被清除。

2. UI层逻辑处理不当：在SplashRoute的UI构建方法中直接执行了页面跳转逻辑，导致每次UI重建时都会触发新的导航操作。

解决方案

方案一：禁用路由历史保留

通过设置keepHistory: false可以确保每次导航时清除历史路由：

AutoRoute(page: BusinessRoute.page, keepHistory: false)

注意事项：此方案会导致BusinessRoute在堆栈中无法保留，如果后续有页面推送到其上，BusinessRoute会被自动移除。

方案二：重构导航逻辑

更健壮的解决方案是将导航逻辑从UI层移至业务逻辑层：

1. 避免在build方法中直接执行导航
2. 使用initState或专门的业务逻辑控制器处理导航
3. 确保导航操作只执行一次

方案三：调整深度链接重建策略

尝试设置rebuildStackOnDeepLink: false，这可以防止深度链接触发时重建整个路由堆栈。

最佳实践建议

1. 合理使用keepHistory：根据业务需求谨慎设置此参数，理解其对路由堆栈的影响。

2. 分离导航逻辑：将导航操作与UI构建分离，避免因UI重建导致多次导航。

3. 考虑原生启动页：如果SplashRoute仅用于品牌展示和简单初始化，建议使用原生启动页方案。

4. 路由守卫：对于关键路由，可以实现路由守卫来控制导航行为。

总结

深度链接的重复调用问题通常源于路由配置和导航逻辑的不当使用。通过合理配置路由参数和重构导航逻辑，可以有效解决这类问题。AutoRoute库提供了灵活的配置选项，开发者需要根据具体业务场景选择最适合的方案。

对于需要在Splash页面进行复杂初始化的情况，建议将初始化逻辑与导航逻辑分离，并确保导航操作的单次执行，这样才能构建出稳定可靠的深度链接功能。