Если короткая ссылка отдаёт 404 или не редиректит, нужно проверить домен, alias, nginx/gateway и привязку ссылки к проекту.
Сначала определите тип ошибки
- браузер показывает 404 сразу;
- открывается не тот сервис;
- redirect идёт на неправильный URL;
- домен не открывается вообще;
- ссылка работает на системном домене, но не работает на собственном.
[ТУТ СКРИНШОТ: браузер с ошибкой 404 при открытии короткой ссылки]
Проверка в CDP
- Откройте карточку короткой ссылки.
- Проверьте, какой домен сохранён в short URL.
- Откройте раздел доменов проекта.
- Убедитесь, что домен имеет статус ACTIVE.
- Проверьте, назначен ли домен default, если ссылка должна создаваться на нём.
Проверка DNS
# пример ручной проверки
nslookup -type=A go.example.com
nslookup -type=TXT go.example.comПроверка маршрутизации
Если DNS правильный, но открывается не CDP или не shortlink route, проблема может быть в nginx-конфигурации. После изменения доменов убедитесь, что CLI обновил конфигурацию и nginx был перезагружен.
Что искать в логах
GET /<alias>
Host: go.example.com
Ожидаемо:
gateway/shortlink route нашёл domain + alias
Плохо:
domain not found
shortlink not found
route returned 404Важно. Если старая ссылка на системном домене работает, а новая на собственном домене нет, почти всегда проблема в domain mapping/default/nginx, а не в самой записи shortlink.
Контрольный чек-лист
- Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
- Проверьте роль пользователя: часть кнопок видна только администратору.
- Откройте DevTools → Network и найдите запрос к
/v1/.... - Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
- Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.
Что приложить к задаче разработчику
Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.
[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]
