Почти все ошибки DBeaver делятся на четыре семейства: программа не запускается, не находит драйвер базы, падает по памяти или не может подключиться. Первое действие одно для всех: откройте журнал через Window → Show View → Error Log и прочитайте текст ошибки целиком, а дальше идите в нужный раздел этой статьи. Ошибки подключения здесь разобраны коротко, потому что им посвящена отдельная инструкция как подключиться к базе данных в DBeaver. Если программа ещё не стояла на компьютере, сначала пройдите установку DBeaver на Windows, macOS и Linux.
Рекомендуем курсы по DBeaver
ЭдюсонБизнес-аналитик: тариф Базовый109 900 ₽6 месяцев
НетологияETL-разработчик: пайплайны, хранилища данных и BI-решения41 300 ₽5 месяцев
Яндекс ПрактикумDataLens: анализ и визуализация данныхБесплатно15 часов- ЭдюсонБизнес-аналитик: тариф PRO136 395 ₽6 месяцев
- НетологияSQL и получение данных33 900 ₽9 недель
Где искать текст ошибки
Всплывающее окно показывает только первую строку. Полный текст со стеком вызовов лежит в журнале: двойной клик по записи в Error Log открывает подробности. Те же данные пишутся в файлы, и по документации DBeaver они лежат в папке рабочего пространства.
| Система | Папка с логами |
|---|---|
| Windows | %APPDATA%\DBeaverData\workspace6\.metadata |
| macOS | ~/Library/DBeaverData/workspace6/.metadata |
| Linux | ~/.local/share/DBeaverData/workspace6/.metadata |
Файл .log хранит ошибки и предупреждения, dbeaver-debug.log добавляет к ним отладочную информацию и обрезается на 10 МБ. Когда программа не стартует и рабочего пространства ещё нет, логи пишутся в папку configuration внутри каталога установки и в ~/.eclipse. Пункт Help → Collect Diagnostic info собирает всё это в один архив, но помните, что в нём могут оказаться пароли подключений.
DBeaver не запускается
Когда DBeaver не открывается вовсе или закрывается через секунду после запуска, причины сводятся к трём: чужая Java, поломанный кеш после обновления и системные библиотеки на Linux. Разберём по тексту ошибки.
UnsupportedClassVersionError или «Failed to find a Main Class»
DBeaver с версии 23.0 везёт Java с собой: страница загрузки прямо говорит, что программе нужна Java 25 или новее и во все дистрибутивы вложен OpenJDK 25. Ошибка появляется, когда запуск уходит в системную Java старой версии, например Java 8 или 17. Ровно так было в обращении на GitHub после обновления до 25.2.5: в логах стояла Java 20 от Oracle, и разработчики посоветовали переустановить программу с включённой опцией Include Java.
- Запустите установщик заново и оставьте галочку Include Java.
- Если ставили из ZIP-архива, проверьте, что в папке программы есть каталог
jre. Удалять его стоит только тогда, когда вы сознательно хотите работать на своей Java 25+. - На Linux с пакетом из репозитория дистрибутива переключите Java по умолчанию на новую: в Arch это
archlinux-java set, в Debian и Ubuntuupdate-alternatives --config java.
Failed to load the JNI shared library
Классическая ошибка на Windows 10 и 11: программа пытается загрузить jvm.dll из системной Java, а разрядность не совпадает или версия не подходит.
В похожем случае с Java 1.8 разработчики ответили тем же: DBeaver идёт со своей JRE, системная только мешает, ставьте заново с Include Java. Это касается обеих редакций, Community и PRO собраны на одной платформе.
Не стартует после обновления
Для этого случая в документации по параметрам запуска есть ключ -clean: он очищает кеши Eclipse и рекомендован именно когда DBeaver не запускается после апгрейда. Запустите один раз из терминала:
dbeaver -cleanНа Windows удобнее вызвать dbeaverc.exe из папки программы: эта версия не открывает отдельное окно и печатает сообщения прямо в консоль, так что причину видно сразу. Если обновляли распаковкой архива поверх старой версии, удалите папку целиком и распакуйте заново, настройки при этом не пострадают, они лежат в DBeaverData. Порядок обновления и удаления по системам есть в инструкции по установке DBeaver.
Linux: мерцает экран, нет браузера, ошибки GTK
На Ubuntu, Astra Linux и ALT три частые проблемы собраны в официальном разделе про системные сбои: мерцание лечится переменной GTK_IM_MODULE=ibus в ~/.profile, ошибка «No more handles because there is no underlying browser available» пропадает после установки libwebkit2gtk, а предупреждение gtk_box_gadget_distribute убирает строка gtk-overlay-scrolling = false в ~/.config/gtk-3.0/settings.ini.
Если правка конфигов GTK и переменных окружения для вас тёмный лес, разобраться с этим слоем помогут курсы по Linux.
Канал основателя Checkroi Вани Буявца3 700 человек читают мой Телеграм-канал про нейросетиСобрал промпты для Claude Code и ChatGPT, разборы ИИ-инструментов и лайфхаки по продвижению бизнеса в одном местеПрисоединитьсяОшибки драйверов: Error resolving driver libraries и Can’t create driver instance
DBeaver скачивает JDBC-драйверы из Maven при первом подключении, в дистрибутиве их нет. По документации Driver Manager файлы складываются в DBeaverData/drivers/maven/maven-central/. Если сети нет, репозиторий закрыт прокси или файрволом, вы получите «Error resolving driver libraries», а следом «Can’t create driver instance. Most likely required jar files are missing».
- Откройте настройки соединения, нажмите Edit Driver Settings и на вкладке Libraries нажмите Download ещё раз. Старые записи в списке иногда мешают, поэтому разработчики в обсуждении этой ошибки советуют сначала нажать Reset to default.
- Если выходите в интернет через корпоративный прокси, впишите его хост, порт и логин в настройках драйверов: Window → Preferences → Connections → Drivers.
- Без интернета скачайте
.jarдрайвера на другом компьютере с Maven Central или сайта вендора и добавьте вручную: Databases → Driver Manager, нужный драйвер, Libraries → Add File, затем Find Class.
Для PostgreSQL этот сценарий с закрытой сетью разобран подробнее в статье как подключить DBeaver к PostgreSQL.
CheckroiПодборка курсов по DBeaver7 курсов • 3 школыСравните цены, школы, программу и найдите выгодные предложения по обучениюСравнить→
Ошибки подключения: коротко
Если драйвер загрузился, а база всё равно не отвечает, ошибка почти всегда сидит между клиентом и сервером: сеть, порт, права пользователя. Сверьте текст с таблицей и переходите по ссылке на полный разбор.
| Текст ошибки | Что проверить первым |
|---|---|
| Connection refused | Запущен ли сервер, тот ли порт, открыт ли он в файрволе |
| Connection timed out | Доступен ли хост из вашей сети, не нужен ли SSH-туннель |
| Access denied, password authentication failed | Логин, пароль и права пользователя на этой базе |
| no pg_hba.conf entry for host | Правило для вашего адреса в pg_hba.conf на сервере PostgreSQL |
| Public Key Retrieval is not allowed | Свойство драйвера allowPublicKeyRetrieval для новых MySQL |
| SSL error, The server does not support SSL | Вкладка SSL в настройках соединения: включён ли SSL на сервере и нужен ли сертификат |
Каждая строка с порядком проверки есть в инструкции по подключению к базе в DBeaver, там же чек-лист «не подключается» по шагам.
Java heap space и зависания на больших таблицах
Ошибка «Java heap space» означает, что DBeaver упёрся в лимит памяти Java. Разработчик проекта в ответе на обращение называет цифру: у Community-версии лимит по умолчанию 1 ГБ, и пользователь получил ошибку, потому что выставил размер выборки в 500 000 строк.
- Уменьшите ResultSet fetch size в Window → Preferences → Editors → Data Editor до разумного значения, разработчик советует около 1000 строк, и включите там же Use SQL to limit fetch size, чтобы ограничение уходило в сам запрос через LIMIT.
- Поднимите лимит памяти: откройте
dbeaver.iniв папке программы и после строки-vmargsисправьте или добавьте-Xmx4000m. Пример именно с таким значением приведён в документации по параметрам запуска. - Большие выгрузки делайте частями: экспорт по сегментам описан в статье как выгрузить данные из DBeaver в Excel и CSV.
Где лежит dbeaver.ini: на Windows в C:\Program Files\DBeaver\, на macOS внутри пакета DBeaver.app/Contents/Eclipse/, на Linux в /usr/share/dbeaver-ce/. На Windows файл в Program Files придётся открывать от администратора.
No active connection: почему запрос не выполняется
Сообщение «No active connection» появляется в двух ситуациях. Первая: SQL-редактор открыт как отдельный файл и не привязан ни к одному соединению. Нажмите Ctrl+9 или кликните поле Active datasource на панели инструментов и выберите базу, текст запроса при этом сохранится.
Вторая: соединение было, но сервер разорвал его за время простоя. Пользователи жалуются, что после суток в свёрнутом окне DBeaver показывает «Can’t read data — no active connection» несколько раз подряд.
Лечится переподключением: правый клик по соединению в дереве и пункт Invalidate/Reconnect, он же есть в меню Database.
Канал основателя Checkroi Вани БуявцаЗабирайте промпты и обучение по нейросетям в моём Телеграм-каналеБольше 3 700 человек уже применяют Claude Code, ChatGPT и другие нейросети в работе, учёбе, бизнесе и жизниПерейти в каналКодировка: ромбики и знаки вопроса вместо русских букв
Кодировки в DBeaver ломаются в трёх местах, и чинятся они по-разному. Кракозябры в данных обычно рождаются в соединении: клиент и сервер говорят в разных кодировках, а DBeaver только показывает результат. Для MySQL добавьте в свойства драйвера characterEncoding=UTF-8, это штатный параметр из документации MySQL Connector/J. Для PostgreSQL проверьте client_encoding на стороне сервера.
Если ромбики только в открытых .sql-файлах, проблема в кодировке текстовых файлов рабочего пространства, её меняют в Window → Preferences → General → Workspace. Последний вариант: строка -Dfile.encoding=UTF-8 после -vmargs в dbeaver.ini. Если кракозябры в меню и кнопках самой программы, смотрите инструкцию как переключить DBeaver на русский, там этот случай разобран отдельно.
Если ничего не помогло: сброс рабочего пространства
Все настройки, соединения и скрипты DBeaver хранит отдельно от программы, в папке DBeaverData, пути к ней по системам есть в документации о рабочем пространстве. Поэтому переустановка программы сама по себе редко что-то чинит: сломанный конфиг остаётся на месте.
- Закройте DBeaver и скопируйте файл
workspace6/General/.dbeaver/data-sources.json, в нём все ваши подключения. - Переименуйте папку
workspace6, например вworkspace6.bak. - Запустите программу: она создаст чистое рабочее пространство. Верните
data-sources.jsonна место или заведите соединения заново.
Штатный путь без переименования папок: File → Switch workspace → Other и новый каталог, либо ключ -data с путём при запуске.
Где освоить DBeaver и SQL системно
Разовую ошибку вы почините по этой статье, но каждая из них упирается в понимание, как устроены драйверы, соединения и сама база. Если работать с данными предстоит постоянно, посмотрите курсы с практикой в DBeaver и курсы по SQL, где клиент к базе изучают вместе с языком запросов.
| Курс | Школа | Стоимость со скидкой | В рассрочку | Длительность | Обзор курса от Checkroi |
|---|---|---|---|---|---|
| Бизнес-аналитик: тариф Базовый Перейти на сайт курса | Эдюсон | 109 900 ₽ | 4579 ₽/мес. | 6 месяцев | Обзор курса |
| Бизнес-аналитик: тариф PRO Перейти на сайт курса | Эдюсон | 136 395 ₽ | 5683 ₽/мес. | 6 месяцев | Обзор курса |
| ETL-разработчик: пайплайны, хранилища данных и BI-решения Перейти на сайт курса | Нетология | 41 300 ₽ | 2294 ₽/мес. | 5 месяцев | Обзор курса |
| SQL и получение данных Перейти на сайт курса | Нетология | 33 900 ₽ | 2313 ₽/мес. | 9 недель | Обзор курса |
| Бизнес-аналитик: тариф Мастер Перейти на сайт курса | Эдюсон | 176 295 ₽ | 7345 ₽/мес. | 6 месяцев | Обзор курса |
Больше программ — в полном каталоге курсов по DBeaver
