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

Симптом всегда одинаковый и обидный: ты нажимаешь на ссылку, а она открывается в браузере. Приложение установлено, ссылка правильная, ошибки нет.
Ошибки не будет и дальше — в этом вся подлость. Провалившаяся проверка домена выглядит ровно как обычная ссылка на сайт. Разберём три причины по частоте.
Сначала пойми, какой у тебя тип ссылки
Тридцать секунд, которые экономят вечер.
Если твоя ссылка выглядит как 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: ссылку открыли не оттуда
Ссылка рабочая, файл правильный, а из телеграма всё равно открывается веб-версия.
Так и задумано. Встроенные браузеры мессенджеров и соцсетей часто открывают адрес внутри себя и не отдают его системе — значит, шанса перехватить ссылку у приложения нет.
Как проверить. Отправь себе ту же ссылку в заметки или в почту и нажми оттуда. Открылось приложение — с ссылкой всё в порядке, проблема в источнике перехода.
Как починить. Полностью — никак, это чужое поведение. Что реально помогает:
- сделать веб-страницу по тому же адресу нормальной, с кнопкой «Открыть в приложении»;
- не прогонять ссылку через трекеры и сокращатели — редирект по дороге тоже ломает сопоставление;
- в письмах и уведомлениях вести на свой домен напрямую, а не через промежуточный сервис.
Что делать по порядку
Коротко, если чинишь прямо сейчас:
- Открой файл проверки в браузере — редирект и HTML отсекаются сразу.
- Сверь отпечаток подписи и bundle id внутри файла со сборкой, которая стоит на телефоне.
- Переустанови приложение.
- Проверь ссылку из заметок, а не из мессенджера.
Если после четвёртого пункта всё работает — ты нашёл причину 3 и чинить больше нечего.
Почему нет никакой ошибки?
Потому что для системы это не ошибка. Она спросила, ей не ответили — и она поступила безопасно: открыла обычную веб-страницу. Молчание тут по замыслу, иначе любой сайт мог бы показывать пользователю чужие системные ошибки.
На симуляторе работает, на телефоне нет — почему?
Чаще всего дело в подписи сборки: в файле указан отпечаток одной сборки, а на устройстве стоит другая. Проверяй диплинки на той же сборке, которую отдаёшь людям, — отладка на другой версии здесь бесполезна.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





