Гайды

Почему диплинк не открывает приложение — три причины и как проверить каждую

Иллюстрация: письмо приходит не в тот почтовый ящик, соседний закрыт

Симптом всегда одинаковый и обидный: ты нажимаешь на ссылку, а она открывается в браузере. Приложение установлено, ссылка правильная, ошибки нет.

Ошибки не будет и дальше — в этом вся подлость. Провалившаяся проверка домена выглядит ровно как обычная ссылка на сайт. Разберём три причины по частоте.

Сначала пойми, какой у тебя тип ссылки

Тридцать секунд, которые экономят вечер.

Если твоя ссылка выглядит как myapp://something — это схема, и для неё вся диагностика ниже не нужна. Схема не открывает приложение только в одном случае: приложения нет или его схему перехватило другое. И в браузере она не откроется никогда — она просто не сработает.

Если ссылка выглядит как обычный https://твойпроект.ru/... — это универсальная ссылка, и читай дальше. Разница между ними разобрана в что такое диплинк.

Причина 1: файл проверки не отдаётся так, как надо

Это девять случаев из десяти.

Телефон ищет на твоём домене файл: на Android — /.well-known/assetlinks.json, на iOS — /.well-known/apple-app-site-association. Не нашёл, получил не то — молча решает, что ссылка не твоя.

Как проверить. Открой адрес файла в браузере на компьютере. Смотри на четыре вещи:

  • отдаётся ли он вообще (не 404, не страница входа);
  • по HTTPS ли — по http не считается;
  • нет ли редиректа: если адрес в строке изменился (например, добавился www или слэш) — проверка уже провалена, редиректы запрещены;
  • приходит ли JSON, а не HTML-страница твоего сайта. Часто SPA-фреймворк отдаёт на неизвестный путь красивую страницу с кодом 200 — для телефона это мусор.

Как починить. Положи файл как статику, отдаваемую напрямую, с типом application/json. Убедись, что правило редиректа на www или на слэш не задевает путь .well-known. У файла iOS не должно быть расширения .json — просто apple-app-site-association.

Отдельная мелочь, которая ломает всё: проверь идентификаторы внутри файла. На Android — отпечаток сертификата подписи (у debug-сборки и релизной он разный!), на iOS — префикс команды и bundle id.

Причина 2: проверка уже провалилась и закэшировалась

Ты нашёл ошибку из причины 1, починил файл, обновил страницу — а ссылка всё равно уходит в браузер. И вот здесь люди начинают править то, что уже работает.

Как проверить. Просто вспомни: файл был сломан на момент установки приложения?

На Android проверка домена выполняется при установке. Приложение поставилось, когда файл лежал криво, — результат «не подтверждено» запомнился, и правка файла сама по себе его не отменит.

На iOS файл забирается не с твоего сервера напрямую, а через CDN Apple — свежая версия расходится не мгновенно.

Как починить. Переустанови приложение — это самый быстрый способ заставить Android перепроверить домен. На iOS — переустановка плюс немного терпения. И проверь в настройках телефона, в разделе про открытие ссылок по умолчанию: там видно, признана ли твоя ссылка принадлежащей приложению. Если система предлагает выбрать вручную — значит, автоматическая проверка не прошла.

Причина 3: ссылку открыли не оттуда

Ссылка рабочая, файл правильный, а из телеграма всё равно открывается веб-версия.

Так и задумано. Встроенные браузеры мессенджеров и соцсетей часто открывают адрес внутри себя и не отдают его системе — значит, шанса перехватить ссылку у приложения нет.

Как проверить. Отправь себе ту же ссылку в заметки или в почту и нажми оттуда. Открылось приложение — с ссылкой всё в порядке, проблема в источнике перехода.

Как починить. Полностью — никак, это чужое поведение. Что реально помогает:

  • сделать веб-страницу по тому же адресу нормальной, с кнопкой «Открыть в приложении»;
  • не прогонять ссылку через трекеры и сокращатели — редирект по дороге тоже ломает сопоставление;
  • в письмах и уведомлениях вести на свой домен напрямую, а не через промежуточный сервис.

Что делать по порядку

Коротко, если чинишь прямо сейчас:

  1. Открой файл проверки в браузере — редирект и HTML отсекаются сразу.
  2. Сверь отпечаток подписи и bundle id внутри файла со сборкой, которая стоит на телефоне.
  3. Переустанови приложение.
  4. Проверь ссылку из заметок, а не из мессенджера.

Если после четвёртого пункта всё работает — ты нашёл причину 3 и чинить больше нечего.

Почему нет никакой ошибки?

Потому что для системы это не ошибка. Она спросила, ей не ответили — и она поступила безопасно: открыла обычную веб-страницу. Молчание тут по замыслу, иначе любой сайт мог бы показывать пользователю чужие системные ошибки.

На симуляторе работает, на телефоне нет — почему?

Чаще всего дело в подписи сборки: в файле указан отпечаток одной сборки, а на устройстве стоит другая. Проверяй диплинки на той же сборке, которую отдаёшь людям, — отладка на другой версии здесь бесполезна.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →