Base de conocimiento

Solución de problemas y guías

DBeaver troubleshooting guides for Community download and install issues: connections, Windows SmartScreen, Java 25, upgrades, Defender checks, and antivirus false positives. Jump the index, then return to download DBeaver 26.1.5 or the FAQ when you need a short answer.

Lista de primera consulta

A short path from install to a successful SELECT.

  1. Install Community 26.1.5 with the installer for your OS (prefer exe/DMG/deb over overwriting a ZIP tree).
  2. Create a connection in Database Navigator and test credentials.
  3. Open SQL Editor, write a limited SELECT, run the selection with Ctrl+Enter.
  4. Confirm rows in the result grid and note the status bar fetch timing.
SELECT c."FirstName", c."LastName" FROM "Customer" c LIMIT 20;

No se puede conectar to the database

Advertencia
Connection fails or hangs before the navigator shows schemas.
Causa
Wrong host/port, driver mismatch, firewall, missing SSH tunnel parameters, or incomplete custom auth on imported CSV/XML connections.
Solución
  1. Re-open connection settings and confirm driver, host, port, database, and user.
  2. Use Test connection before saving.
  3. If you use SSH, set required database parameters before testing the tunnel (Firebird-related tunnel testing was fixed when parameters were missing).
  4. On Linux browser-based auth, ensure a supported browse action exists for the desktop.
Verificar
Navigator expands schemas and a trivial query returns rows.

Windows SmartScreen bloquea el inicio

Advertencia
Windows reports an unrecognized app and refuses to start dbeaver.exe.
Causa
Reputation delay on new builds, or historically an unsigned executable inside a ZIP package.
Solución
  1. Prefer the Windows installer build over ZIP when possible.
  2. In SmartScreen, open More info, then Run anyway only if you trust the package source and version.
  3. Confirm the version string matches 26.1.5 after launch.
Verificar
Application window opens and Help shows Community 26.1.5.

Antivirus false positives

Advertencia
AV or browser advisors quarantine the installer or dbeaver.exe.
Causa
Heuristic engines sometimes flag Java desktop apps or freshly published binaries. Community history includes single-engine VirusTotal hits that cleared on rescan.
Solución
  1. Re-download and compare checksums when published.
  2. Submit the file to your AV vendor or wait for signature updates.
  3. Do not disable AV globally; scope an exception only to the verified install path if policy allows.
Verificar
Clean scan on the same digest, then successful launch.

More on trust and provenance

Java requirements and the jre folder

Causa
DBeaver needs Java 25 or higher. Older system JDKs fail to start the workbench.
Solución
  1. Use the official package that bundles OpenJDK 25 (standard since 23.0).
  2. To force a local JDK, delete the jre directory inside the install folder and point the environment at Java 25+.
Verificar
About dialog loads without JVM version errors.

Upgrading without losing connections

  1. Run the new Windows installer, or install the new deb/rpm/DMG package.
  2. If you use ZIP, extract to a new directory. Do not unzip over the previous tree.
  3. Start DBeaver and confirm connections still appear.

Settings remain in the user DBeaverData folder. Removing the old application directory does not remove that data.

Microsoft Comprobación de exclusión de Defender on startup

Advertencia
Startup shows a Comprobación de exclusión de Defender error on Eclipse-based builds.
Solución
  1. Open Window → Preferences → General → Startup and Shutdown.
  2. Enable skip for Microsoft Comprobación de exclusión de Defender when your policy allows.
  3. Alternatively create .eclipse/.settings/org.eclipse.ui.prefs with:
eclipse.preferences.version=1 windows.defender.startup.check.skip=true
Verificar
Restart completes without the exclusion error dialog.

Leer claves foráneas on an ER diagram

When a relationship line is selected, the status area can show the constraint name such as fk_payment_customer. Use diagrams to confirm cardinality before writing joins.

ER Diagram · relationship detail
DBeaver dark ER diagram with foreign key relationship lines between tables

Buenas prácticas

  • Keep result fetch limits modest on large tables to avoid UI slowdowns noted by Softonic-style heavy-grid feedback.
  • Store production credentials in OS secret stores or connection auth flows; avoid sharing screenshots that include secrets.
  • Use saved data-transfer tasks for repeatable imports so mappings survive updates.
  • After each Community minor, skim the release notes for driver-specific fixes that affect your engines.

Descargar 26.1.5 FAQ

Continuar

Páginas relacionadas

Descargar Community 26.1.5

Windows, macOS, and Linux packages with changelog and integrity notes.

Explorar funciones de DBeaver

SQL Editor, Data Editor, Diagramas ER, transfer, and AI Chat.

Resolver problemas de instalación

Java, SmartScreen, antivirus, upgrades, and connection checks.

Also read the FAQ de DBeaver and trust and security pages. Last reviewed: .

Descargar