Database error driver not loaded

First: I am using Qt v5.3.1 with MinGW 4.8.2, and Window 7 32bit platform.

When run my application in windows 7, I found it is working fine in connect to database only if Qt environment is installed, also when move the same application to another platform like windows xp by Virtual PC, unfortunately I found the connection to database fail too, and an error message appears driver not loaded, but the application works fine but without connection to database.

My attempts:

• I have used QSqlDatabase::drivers() to check if sqlite supported
  in the system, and the result was, sqlite database
  supported with many other types.

• I have used isValid() to check if there is a valid driver, but the
  function return false, and this indicates that the database type is
  not available or could not be loaded.

The following is the code that I use:

database.h

class database
{
public:
    static QSqlDatabase db;
    static QString dbPath;
    database();

    static void connect();
    static bool openConnection();
    static void CloseConnection();
    static void removeDB();
};

database.cpp

QSqlDatabase database::db = QSqlDatabase::addDatabase("QSQLITE");
QString database::dbPath = "";

database::database(){
}

void database::connect(){
    database::dbPath = "database.db";
    database::db.setDatabaseName(database::dbPath);
}

void database::CloseConnection(){
    database::db.close();
}

void database::removeDB(){
    database::db.removeDatabase(database::db.defaultConnection);
}

Also I have checked if the database file exists or not, and also I have opened the connection to database.

database::connect();
  if(QFile::exists(database::dbPath)){
      if(database::db.open()){
          ui->label->setText(ui->label->text() + "Connected.");
          QSqlQuery qry;
          qry.prepare("SELECT * FROM users");
          qry.exec();
          while(qry.next()){
              ui->listWidget->addItem(qry.value("username").toString());
              ui->listWidget->item(ui->listWidget->count()-1)->setData(Qt::UserRole, qry.value("id").toString());
            }
          database::CloseConnection();
        }else{
          ui->label->setText(ui->label->text() + "Failed to connect to database");
        }
    }else{
      ui->label->setText(ui->label->text() + "Database file does not found");
    }

I don’t know what’s the problem in the connection with database, everything is alright, and there is no missing files in my application, and the database file beside the executable file.

How to solve this problem ?

При вызове QSqlDatabase::addDatabse(«QPSQL») программа пишет:

В процессе работы программы при вызове QSqlDatabase::addDatabse делается динамический поиск dll-файлов SQL-драйверов в определенных каталогах. Для драйвера QPSQL должна быть найдена библиотека qsqlpsql.dll, после чего выполняется попытка ее загрузки.

Для этого загружаются другие неявно связанные с ней dll-библиотеки вместе со своими зависимостями. Если всё дерево необходимых dll-библиотек найдено, то qsqlpsql.dll будет успешно загружена и Qt сможет использовать этот драйвер.

Но сложность в том, что при отсутствии какой-либо библиотеки Windows не выдаст красивого сообщения об этом и придется разбираться другими способами.

Разбираемся

Нам надо выяснить, какие dll-библиотеки требуются для работы программы и куда их нужно положить.

Для этого достаточно в общих чертах представлять, как Windows ищет dll, а именно, что сначала производится поиск в каталоге exe-файла, а в конце — по путям, указанным в переменной окружения PATH. PATH удобно использовать на машине разработчика, но этот вариант рассматривать не будем т.к. это не соответствует изначальной задаче. 

Также надо знать, в каких каталогах QSqlDatabase::addDatabse ищет драйверы SQL. Существуют способы указать Qt альтернативные пути, где искать плагины (в т.ч. SQL), но не будем заниматься и этим.

Исследуем

Используем Прекрасную программы DependencyWalker, которая показывает дерево зависимостей dll и exe-файлов.

Сначала открываем с помощью неё исполняемый файл программы и смотрим, какие dll-библиотеки должны быть доступны, ищем их в каталоге установки Qt и компилятора и кладем рядом с исполняемым файлом. Теперь программа должна запускаться и доходить до вызова QSqlDatabase::addDatabse.

Чтобы увидеть, где Qt ищет SQL-драйверы, добавляем переменную окружения QT_PLUGIN_PATH = 1 (например, в настройках параметров запуска приложения в QtCreator), запускаем программу и изучаем ее вывод. Кроме прочего должны быть примерно такие строки:

QFactoryLoader::QFactoryLoader() checking directory path «C:/Qt/Qt5.5.1/5.5/mingw492_32/plugins/sqldrivers»
…
QFactoryLoader::QFactoryLoader() checking directory path «C:/projects/build-foobar-Desktop-Release/release/sqldrivers»

Из них становится ясно, что по умолчанию Qt ищет SQL-драйверы в каталоге установки и в подкаталоге sqldrivers рядом с exe-файлом. Поэтому находим qsqlpsql.dll в каталоге установки Qt (примерно в C:Qt5.5.1mingw491_32binpluginssqldrivers) и копируем в подкаталог sqldrivers рядом с exe-файлом.
Если все сделано верно, то после вызова QSqlDatabase::addDatabse должно вывестись:

Если не удалось, то попробовать положить qsqlpsql.dll в plugins/sqldrivers.

Далее с помощью DependencyWalker исследуем зависимости qsqlpsql.dll.

Кроме зависимостей от библиотек Qt и компилятора, будет зависимость от libpq.dll.

Проще всего взять libpq.dll из каталога установки PostgreSQL (примерно в C:Program Files (x86)PostgreSQL10bin). Здесь есть две важнейшие особенности:

1) разрядность libpq.dll должна совпадать с разрядностью приложения. Под Windows стандартный SDK Qt5 с официального сайта 32-разрядный. т.е. необходима 32-разрядная версия libpq.dll, которую можно взять из x86-версии PostgreSQL. Это не влияет на разрядность сервера PostgreSQL, к которому будет подключаться приложение;

2) libpq.dll необходимо располагать рядом с exe-файлом, а не рядом с qsqlpsql.dll. Все остальные dll, от которых зависит libpq.dll, необходимо класть также рядом с exe-файлом приложения.

Теперь все тем же DependencyWalker исследуем зависимости libpq.dll в каталоге установки PostgreSQL.

В зависимости от версии PostgreSQL у libpq.dll могут быть разные dll-зависимости. Находим их все в каталоге установки PostgreSQL и копируем рядом с exe-файлом. Не забываем пройтись по всем зависимостям всех добавляемых dll. 

Сравниваем

Для PostgreSQL 10 набор уже другой:

libpq.dll

libssl-1_1.dll

libcrypto-1_1.dll

libintl-8.dll

libiconv-2.dll