Данная статья подготовлена на основе предоставленных технических данных из открытых источников. Внимание: тема запроса («Горы ль вы высокие рассорка отзывы кто делал») не имеет прямого отношения к полученной технической информации, которая посвящена проблемам экранирования спецсимволов в JQL (Jira Query Language) и онлайн-инструментам для удаления специальных символов. Ниже представлен подробный разбор имеющихся технических материалов.
Содержание
- Проблема экранирования зарезервированных символов в Jira (JQL)
- Детали бага JRACLOUD-75866
- Обходные пути и рекомендации
- Инструменты для удаления специальных символов (Text Utils)
Проблема экранирования зарезервированных символов в Jira (JQL)
Согласно официальной документации Atlassian, к которой ссылается тикет JRACLOUD-75866, JQL (Jira Query Language) имеет строгий список зарезервированных символов. Использование этих символов в поисковых запросах без корректного экранирования приводит к ошибкам парсинга или некорректным результатам поиска.
Список зарезервированных символов:
- Пробел (
" ") - Точка (
.) - Запятая (
,) - Точка с запятой (
;) - Вопросительный знак (
?) - Вертикальная черта (
|) - Звездочка (
*) - Слэш (
/) - Процент (
%) - Символ каретки (
^) - Доллар (
$) - Сетка (
#) - Собака (
@) - Квадратные скобки (
[ ])
Стандартное правило экранирования: Для использования этих символов в запросах их необходимо заключить в кавычки (одинарные ' или двойные "). Дополнительно, при поиске по текстовым полям, если символ входит в список зарезервированных для текстового поиска, его необходимо предварять двумя обратными слэшами (\).
Детали бага JRACLOUD-75866: Экранирование кавычек не работает
Тикет JRACLOUD-75866 (создан 18 января 2021 года, актуален на июль 2026 года) описывает критическую проблему: стандартное экранирование двойных кавычек (") не функционирует, даже если синтаксис соблюден верно.
Ключевые параметры тикета:
- Тип: Suggestion (Предложение/Баг)
- Статус: Unresolved (Не решен)
- Голосов: 227
- Наблюдателей: 189
- Компонент: JQL Search
Сценарий воспроизведения (Steps to Reproduce):
- Выполнить JQL-запрос, включающий спецсимволы в экранированном виде, например:
summary ~ "[change]"(поиск точной фразы[change]в поле Summary). - Ожидаемый результат: Отображаются только задачи, содержащие точный текст
[change]. - Фактический результат: Возвращаются все задачи, содержащие слово
change(скобки игнорируются/парсятся некорректно).
Затронутые символы:
Проблема воспроизводится не только для квадратных скобок, но и для:
- Двоеточия (
:) - Дефиса/тире (
-) - Точки (
.)
Это означает, что точный поиск фраз, содержащих пунктуацию или скобки, в текущей реализации JQL Cloud невозможен стандартными методами.
Обходные пути (Workarounds)
В описании тикета указан единственный рабочий вариант на данный момент:
Использовать поиск точной фразы (Exact Phrase Search): Обернуть всю искомую строку в кавычки.
Ограничение обходного пути:
Данный метод работает только тогда, когда вся искомая строка используется целиком в качестве критерия поиска. Частичное совпадение или комбинирование с другими условиями может снова вызвать ошибку парсинга спецсимволов.
Инструменты для удаления специальных символов: Remove Special Characters (Text Utils)
Как альтернативный подход к работе с «грязными» данными перед загрузкой в Jira или для предобработки логов, можно использовать онлайн-утилиты очистки текста.
Обзор сервиса Text Utils ⎻ Remove Special Characters
- Назначение: Удаление специальных символов из текста.
- Функционал: Позволяет оставить только алфавитно-цифровые символы (опция Keep alphanumeric), удаляя пунктуацию, скобки, кавычки и прочие спецсимволы.
- Дата публикации/обновления: 02 марта 2026 года.
- Монетизация: Проект зависит от рекламы (просят отключить AdBlock).
Сценарии применения в контексте JQL:
- Предобработка данных: Очистка импортируемых заголовков (Summary) от скобок, двоеточий и дефисов перед загрузкой в Jira, чтобы избежать проблем с поиском.
- Формирование безопасных запросов: Автоматическое удаление проблемных символов из пользовательского ввода перед вставкой в JQL-строку.
- Нормализация логов: Подготовка текстовых выгрузок для анализа.
На момент 17 июля 2026 года проблема корректного экранирования спецсимволов (скобок, двоеточий, дефисов, точек) в JQL-запросах Atlassian Jira Cloud остается открытой (тикет JRACLOUD-75866, 227 голосов). Стандартная документация по экранированию через \ и кавычки не работает для указанной группы символов.
Рекомендации для администраторов и разработчиков:
- Избегать использования квадратных скобок
[], двоеточий:, дефисов-и точек.в полях Summary, если планируется точный поиск по этим фрагментам. - Использовать поиск точной фразой (
"full phrase") как единственный надежный способ нахождения задач с пунктуацией. - Рассмотреть предварительную очистку данных через инструменты вроде Text Utils (Remove Special Characters) перед импортом в Jira.
- Проголосовать за тикет JRACLOUD-75866 в портале Atlassian для повышения приоритета исправления.
Примечание: Информация основана на данных тикета Atlassian Jira (JRACLOUD-75866) и описании сервиса text-utils.com. Данные актуальны на .