Сравните исходную строку с текстом, который вернул декодер, до открытия ссылки или подстановки в форму. Если QR успешно распознан, но буквы неверны, начните с данных и кодировки. Изменение размера картинки не восстановит символы, которые были заменены ещё перед генерацией.

Создайте короткий тест с кириллицей, латиницей, Ё и ё. Используйте обычный текст без платёжных данных, паролей и ссылок с токенами. Сохраните строку и изображение одной версии, чтобы все проверки относились к одному результату генератора.

Содержимое фиксируют на входе кодера

Условная система получает текст из старой базы, а QR-библиотека уже видит знаки вопроса. Ни выбор UTF-8 в кодере, ни другой сканер не определят утраченные буквы. Сохраните безопасное представление строки непосредственно перед вызовом библиотеки и сравните с ожидаемым образцом.

В ZXing параметр EncodeHintType.CHARACTER_SET задаёт кодировку там, где она применима. Исходный код проекта проверен 10 ноября 2026 года. Название параметра другого генератора может отличаться: сверяйте документацию и фактическую версию, а не передавайте произвольное поле с похожим именем.

Условная трасса
expected text -> generator input
encoding setting -> QR symbol
same image -> decoder A / decoder B
decoded text -> exact comparison

Это диагностическая схема, не готовый вызов API. В настройках своего кодера выберите согласованное кодирование, затем прочитайте результат целевыми клиентами. Само присутствие слова UTF-8 в конфигурации не подтверждает, что параметр дошёл до используемой библиотеки.

Два декодера отделяют генератор от клиента

Прочитайте одно изображение независимым тестовым декодером и тем приложением, которое будет использовать оператор. Сравните возвращённый текст посимвольно. Если результаты различаются, исследуйте настройки и поддержку кодирования клиента. Если оба неверны одинаково, вернитесь к строке и формированию символа.

Где текст изменилсяЧто исследовать
До генератораИсточник и декодирование
В обоих клиентахПараметры кодера
В одном клиентеДекодер и настройки
После ввода в полеРаскладку и обработчики

Если сканер вводит текст как клавиатура, отдельно проверьте раскладку и преобразования ввода. Текст, показанный внутри приложения сканирования, и текст в конечном поле могут различаться. Не меняйте содержимое QR ради компенсации неверной раскладки одного рабочего места.

Для QR со ссылкой разделите декодированный адрес и дальнейшее поведение сайта. Корректный текст кода может привести к редиректу или странице, которая сама неверно декодирует параметры. Сначала сохраните точную строку результата, затем исследуйте следующий этап.

Проверка после исправления сохраняет смысл сообщения

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

Сравните изображение из генератора с тем, что реально попадает на экран или в печатный макет. Если финальная версия вообще не читается, это уже отдельная проверка качества изображения. Не объединяйте отказ распознавания и успешное чтение неверного текста в одну общую ошибку.

На передачу разработчику нужны безопасная исходная строка, версии генератора и двух клиентов, настройки кодирования и результаты чтения. Не требуется публиковать рабочие QR с секретами. Исправление принимают по точному совпадению текста на поддерживаемых устройствах, а не по одному сообщению «код распознан».

Проверенные источники