DBeaver fails to resolve Maven dependencies when downloading a database driver
Error resolving maven dependenciesShort answer
DBeaver downloads driver jars from a Maven repository. When that download fails, the usual causes are a proxy that the driver downloader does not know about, or a repository URL that cannot be reached. Set the proxy under Preferences, Connections, Drivers, or add a local jar with Add File.
Fix it fast
1Find out which cause you have
Open the driver and retry the download from there, so the real message shows. Database menu, Driver Manager, select the driver, Edit, Libraries, select the library, Download/Update.
Database > Driver Manager > (driver) > Edit... > Libraries > Download/Update2Match what you see, then jump to its fix
- 1
Download fails on a company network or VPN, but the same driver downloads at home.A proxy sits between DBeaver and the repositoryFix - 2
The proxy is right, but only some drivers fail, or the failing driver comes from a custom repository.The file repositories list points at an address that is not reachableFix - 3
Both settings are right and the download still fails, for example on an offline workstation.Nothing can be downloaded from this machine at allFix
- 1
What does the error look like?
Error resolving maven dependenciesA driver library does not download automatically
Cause 1 of 3
A proxy sits between DBeaver and the repository
1Check
Driver downloads use their own proxy settings, separate from the connection proxy. They are under Window > Preferences > Connections > Drivers, and they apply only to driver downloads.
Window > Preferences > Connections > Drivers2Fix
Enter Proxy Host, Proxy Port, User and Password there, then retry Download/Update on the library.
Proxy Host: proxy.example.com
Proxy Port: 80803Verify
The library row loses its warning and the download finishes.
Driver editor > Libraries: the jar is listed with a file pathConfirmed by github.com
Cause 2 of 3
The file repositories list points at an address that is not reachable
1Check
'File repositories' holds the URLs of the remote repositories used for downloading drivers, in the same Drivers preference page.
Window > Preferences > Connections > Drivers > File repositories2Fix
Correct or remove the entry that cannot be reached, then retry the download.
Window > Preferences > Connections > Drivers > File repositories3Verify
Download/Update completes for the library.
Driver editor > Libraries > Download/UpdateConfirmed by github.com
Cause 3 of 3
Nothing can be downloaded from this machine at all
1Check
DBeaver supports a local JDBC jar in place of a download. The Driver Manager page describes it as the fallback when a library does not download automatically.
Database > Driver Manager > (driver) > Edit... > Libraries2Fix
Download the vendor's jar on another machine, then Add File and choose it, then Find Class, then OK.
Libraries > Add File > select mysql-connector-j-<version>.jar
Find Class > OK3Verify
Test Connection in the connection settings succeeds.
Edit Connection > Test ConnectionConfirmed by github.com
How do I stop it coming back?
- Set the driver proxy once on every machine behind a corporate proxy.
- Keep a copy of the driver jars you rely on for offline machines.
- Add custom repositories only when you need them; remove dead ones.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Projects of mine built on the same technologies:
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- QistLockA NestJS and React SaaS driving an Android Device Owner agent that locks financed phones when payments lapse.
- ShopGoAn e-commerce aggregator with a Python scraping engine behind its catalog, past 10K Google Play downloads.
Related fixes
Databases
Installing the Airflow MySQL provider fails on pkg-config or mysqlclient
Building the mysqlclient wheel fails during the install
The Airflow MySQL provider depends on mysqlclient, which pip compiles against the MySQL C client library.
2 causes, each with a fixDatabases
A query on Aurora MySQL dies with 'table /rdsdbdata/tmp/#sql... is full'
ERROR 1114 (HY000): The table '/rdsdbdata/tmp/#sqlfd_1586_2' is full
In Aurora MySQL 3, internal temporary tables share one pool, and when that pool and the memory-mapped overflow file are used up, a reader instance ends the query with error 1114.
3 causes, each with a fixDatabases
Azure Database for MySQL refuses a connection that does not use SSL
ERROR 3159 (HY000): Connections using insecure transport are prohibited while --require_secure_transport=ON.
Azure Database for MySQL Flexible Server requires encrypted connections by default (require_secure_transport = ON, TLS 1.2).
4 causes, each with a fixDatabases
Compiling a C or C++ program that includes mysql.h fails
undefined reference to `mysql_init'
The compiler only finds mysql.h when the MySQL client development files are installed and their folder is on the include path.
3 causes, each with a fixDatabases
DBeaver cannot verify the MySQL server certificate
unable to find valid certification path to requested target
DBeaver's MySQL driver is checking the server certificate and Java does not trust the CA that signed it.
2 causes, each with a fixDatabases
Django cannot load MySQLdb and asks whether mysqlclient is installed
Error loading MySQLdb module: Did you install mysqlclient or MySQL-python?
Django's MySQL backend imports MySQLdb, which is provided by the mysqlclient package.
3 causes, each with a fix