문제 해결

onIntent가 실행되지 않음

• 이 링크들 위에 IntentProvider가 있나요?
• 대상에 onIntent 콜백이 있나요? 콜백이 없는 대상은 등록되지 않습니다.
• 데스크톱에서는 포인터를 움직이고 모바일에서는 스크롤하세요. 첫 상호작용 전까지 엔진은 쉽니다.
• 대상이 보이며 실제 너비와 높이를 가지는지 확인하세요.
• 연결을 확인하기 위해 잠시 importance="high", cost="low"를 사용한 뒤 기본값으로 되돌리세요.

onIntent 없이 경로가 프리페치됨

반응형 레이아웃에 숨겨진 링크를 포함해 같은 경로를 가리키는 다른 Next.js Link가 있는지 확인하세요. router.prefetch()를 직접 호출하는 코드도 찾아보세요.

사용자 컴포넌트가 작동하지 않음

컴포넌트는 실제 HTML 요소로 ref를 전달해야 합니다. 그렇지 않다면 div 같은 네이티브 래퍼에 의도 ref를 연결하세요.

모바일에서 테스트

실제 터치 기기를 사용하거나 브라우저 개발자 도구에서 터치 에뮬레이션을 켠 뒤 스크롤하세요. 데스크톱 창을 좁히는 것만으로는 모바일 동작이 활성화되지 않을 수 있습니다.

개발 환경과 프로덕션 환경

중요한 동작은 프로덕션 빌드에서도 확인하세요. React 개발 검사와 프레임워크 도구 때문에 콜백이나 네트워크 요청이 프로덕션과 다르게 보일 수 있습니다.