Данная статья подготовлена на основе информации, полученной из интернет-источников по запросу «11 отбр срс»․ Внимание: предоставленные поисковые системы данные относятся к технической проблеме интеграции с API платформы Traccar (кодировка кириллицы в параметрах запроса), что, вероятно, не соответствует ожидаемой тематике рубрики (возможно, имелось в виду название подразделения, объекта или иного термина)․ Ниже представлен подробный разбор имеющейся технической информации․

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

Дата актуальности информации: (текущая дата системы)․
Источник: Форум поддержки Traccar (Russian Language in Query Params)․
Суть обращения: Пользователь столкнулся с ошибкой сохранения позиции при передаче текста на русском языке в query-параметре message через REST API․

Ключевые симптомы:

• При передаче параметра message на английском языке — запись успешно появляется в отчете․
• При передаче русского текста — запись в колонке message отсутствует․
• В логах сервера фиксируется критическая ошибка базы данных (SQLException)․

Техническая детализация ошибки (Анализ логов)

В ходе диагностики были предоставлены фрагменты серверных логов․ Конфиденциальные данные (ID устройств, IP-адреса, доменные имена) заменены маской в соответствии с политикой безопасности․

Параметры ошибочного запроса:

• ID устройства: (в логах фигурировал как 5 897fb29ff11caedee456)
• Время события: (пример: 2025-03-20 15:11:11)
• Endpoint: http://:5055/?id=*&message=․․․ (домен gts․wise-rep․com замаскирован)
• Инструмент тестирования: Postman․

Текст ошибки (SQLException):

WARN: Failed to save position ‒ Invalid string value: тес․․․ for column attributes at row 1
SQLException (․․․ < QueryBuilder:469 < DatabaseStorage:95 < DefaultDataHandler:47 < ․․․)

Расшифровка байтовой последовательности:

Последовательность тес․․․ представляет собой UTF-8 кодировку русского слова «тест․․․»․ Ошибка Invalid string value указывает на несоответствие кодировки передаваемых данных ожидаемой кодировке колонки attributes в базе данных (вероятно, таблица tc_positions или аналогичная)․

Причина возникновения (Root Cause Analysis)

1. Некорректная обработка URL Encoding: При передаче кириллицы в Query String параметры должны быть процентно-закодированы (Percent-encoded / URL Encoded)․ Например, «тест» → %D1%82%D0%B5%D1%81%D1%82․ Если клиент (Postman или код клиента) отправляет «сырые» UTF-8 байты без кодирования, или сервер не декодирует их корректно перед записью в БД, возникает ошибка коллации/кодировки․
2. Настройки сервера приложений (Jetty/Tomcat): Traccar по умолчанию работает на Jetty․ Для корректной работы с UTF-8 в Query Parameters в конфигурации сервера (или системных свойствах JVM) должны быть заданы параметры:
   • -Dfile․encoding=UTF-8
   • org․eclipse․jetty․server․Request․utf8=true (для старых версий Jetty)
   • Настройка URIEncoding="UTF-8" в коннекторе (если используется Tomcat/прокси)․
3. Коллация Базы Данных: Колонка attributes (тип JSON/TEXT/VARCHAR) должна иметь коллацию, поддерживающую Unicode (например, utf8mb4_unicode_ci для MySQL/MariaDB или UTF8 для PostgreSQL)․ Ошибка Invalid string value часто возникает в MySQL при попытке записать 4-байтовые символы (emoji, редкие иероглифы) в колонку с коллацией utf8 (3 байта) вместо utf8mb4․ Хотя базовая кириллица помещается в 3 байта, ошибка может быть вызвана некорректным интерпретированием байтов из-за пункта 1․

Рекомендации по устранению

Вариант А: Исправление на стороне клиента (Рекомендуемый первый шаг)

Убедиться, что HTTP-клиент корректно кодирует Query Parameters․

• Postman: Вкладка Params — вводить значение в поле Value․ Postman автоматически применит URL Encoding при отправке․ Не вставлять уже закодированную строку вручную в поле URL․
• Программный код (Python requests, Java HttpClient, JS fetch): Использовать встроенные механизмы формирования Query String (например, `params={․․․}` в Python requests), а не конкатенацию строк․

Вариант Б: Настройка сервера Traccar (Серверная часть)

Если клиент отправляет данные верно, проверить настройки JVM и БД:

1. Добавить в скрипт запуска (traccar․service или start․sh/wrapper․conf):

   JAVA_OPTS="-Dfile․encoding=UTF-8 -Dsun․jnu․encoding=UTF-8"

2. Проверить коллацию БД:

   -- MySQL/MariaDB
   ALTER TABLE tc_positions MODIFY attributes JSON CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   -- Или для TEXT/VARCHAR
   ALTER TABLE tc_positions CHANGE attributes attributes TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. Проверить конфигурацию traccar․xml / traccar․conf на предмет настроек базы данных (параметр database․charset или аналогичные)․

Вариант В: Использование Body (POST JSON) вместо Query Params

API Traccar поддерживает прием данных через POST запрос с телом в формате JSON (Content-Type: application/json)․ Это наиболее надежный способ передачи сложных структур и юникод-текста, так как исключает проблемы с парсингом Query String веб-сервером․

POST http://:5055/api/positions
Headers: Content-Type: application/json
Body:
{
 "deviceId": "",
 "latitude": 0․0,
 "longitude": 0․0,
 "attributes": {
 "message": "Текст на русском языке"
 }
}

Резюме

Предоставленная информация по теме «11 отбр срс» содержит исключительно техническую переписку по отладке GPS-трекера/платформы Traccar․ Проблема заключается в ошибке кодировки (Invalid string value) при записи атрибутов позиции с русским текстом, переданным через GET-параметры․

Основные выводы:

• Тема запроса (11 отбр срс) не совпадает с содержанием найденных документов (Traccar API UTF-8 Issue)․
• Ошибка воспроизводима на конкретном инстансе: http://:5055 (ID устройства )․
• Решение: переход на POST JSON API или настройка URL Encoding / UTF-8 на сервере и в БД․