问题排查

onIntent 没有执行

• 这些链接上方是否有 IntentProvider？
• 目标是否提供了 onIntent 回调？没有回调的目标不会注册。
• 在桌面端移动指针，在移动端滚动。第一次交互前，引擎处于休眠状态。
• 确认目标可见，并且有真实的宽度和高度。
• 暂时使用 importance="high" 和 cost="low" 检查连接，然后恢复默认值。

没有 onIntent 也预取了路由

检查是否有另一个 Next.js Link 指向同一路由，包括响应式布局中隐藏的链接。也要查找直接调用 router.prefetch() 的代码。

自定义组件不工作

组件必须把 ref 转发到真实 HTML 元素。否则，请把意图 ref 附加到 div 等原生包装元素。

移动端测试

使用真实触摸设备，或在浏览器开发者工具中启用触摸模拟后滚动。仅缩窄桌面浏览器窗口不一定会启用移动端行为。

开发环境与生产环境

请在生产构建中验证关键行为。React 开发检查和框架工具可能让回调或网络请求看起来与生产环境不同。