Add structured trace for all DB drivers

system/Database/MySQLi/Connection.php

@@ -326,7 +326,12 @@ protected function execute(string $sql)
         try {
             return $this->connID->query($this->prepQuery($sql), $this->resultMode);
         } catch (mysqli_sql_exception $e) {
-            log_message('error', (string) $e);
+            log_message('error', "{message}\nin {exFile} on line {exLine}.\n{trace}", [
+                'message' => $e->getMessage(),
+                'exFile'  => clean_path($e->getFile()),
+                'exLine'  => $e->getLine(),
+                'trace'   => render_backtrace($e->getTrace()),
+            ]);
 
             if ($this->DBDebug) {
                 throw new DatabaseException($e->getMessage(), $e->getCode(), $e);

system/Database/OCI8/Connection.php

@@ -226,7 +226,14 @@ protected function execute(string $sql)
 
             return $result;
         } catch (ErrorException $e) {
-            log_message('error', (string) $e);
+            $trace = array_slice($e->getTrace(), 2); // remove call to error handler
+
+            log_message('error', "{message}\nin {exFile} on line {exLine}.\n{trace}", [
+                'message' => $e->getMessage(),
+                'exFile'  => clean_path($e->getFile()),
+                'exLine'  => $e->getLine(),
+                'trace'   => render_backtrace($trace),
+            ]);
 
             if ($this->DBDebug) {
                 throw new DatabaseException($e->getMessage(), $e->getCode(), $e);

system/Database/Postgre/Connection.php

@@ -205,7 +205,14 @@ protected function execute(string $sql)
         try {
             return pg_query($this->connID, $sql);
         } catch (ErrorException $e) {
-            log_message('error', (string) $e);
+            $trace = array_slice($e->getTrace(), 2); // remove the call to error handler
+
+            log_message('error', "{message}\nin {exFile} on line {exLine}.\n{trace}", [
+                'message' => $e->getMessage(),
+                'exFile'  => clean_path($e->getFile()),
+                'exLine'  => $e->getLine(),
+                'trace'   => render_backtrace($trace),
+            ]);
 
             if ($this->DBDebug) {
                 throw new DatabaseException($e->getMessage(), $e->getCode(), $e);

system/Database/SQLSRV/Connection.php

@@ -155,8 +155,12 @@ public function getAllErrorMessages(): string
         $errors = [];
 
         foreach (sqlsrv_errors() as $error) {
-            $errors[] = $error['message']
-                . ' SQLSTATE: ' . $error['SQLSTATE'] . ', code: ' . $error['code'];
+            $errors[] = sprintf(
+                '%s SQLSTATE: %s, code: %s',
+                $error['message'],
+                $error['SQLSTATE'],
+                $error['code']
+            );
         }
 
         return implode("\n", $errors);
@@ -488,17 +492,23 @@ public function setDatabase(?string $databaseName = null)
      */
     protected function execute(string $sql)
     {
-        $stmt = ($this->scrollable === false || $this->isWriteType($sql)) ?
-            sqlsrv_query($this->connID, $sql) :
-            sqlsrv_query($this->connID, $sql, [], ['Scrollable' => $this->scrollable]);
+        $stmt = ($this->scrollable === false || $this->isWriteType($sql))
+            ? sqlsrv_query($this->connID, $sql)
+            : sqlsrv_query($this->connID, $sql, [], ['Scrollable' => $this->scrollable]);
 
         if ($stmt === false) {
-            $error = $this->error();
+            $trace = debug_backtrace();
+            $first = array_shift($trace);
 
-            log_message('error', $error['message']);
+            log_message('error', "{message}\nin {exFile} on line {exLine}.\n{trace}", [
+                'message' => $this->getAllErrorMessages(),
+                'exFile'  => clean_path($first['file']),
+                'exLine'  => $first['line'],
+                'trace'   => render_backtrace($trace),
+            ]);
 
             if ($this->DBDebug) {
-                throw new DatabaseException($error['message']);
+                throw new DatabaseException($this->getAllErrorMessages());
             }
         }
 

system/Database/SQLite3/Connection.php

@@ -175,7 +175,12 @@ protected function execute(string $sql)
                 ? $this->connID->exec($sql)
                 : $this->connID->query($sql);
         } catch (Exception $e) {
-            log_message('error', (string) $e);
+            log_message('error', "{message}\nin {exFile} on line {exLine}.\n{trace}", [
+                'message' => $e->getMessage(),
+                'exFile'  => clean_path($e->getFile()),
+                'exLine'  => $e->getLine(),
+                'trace'   => render_backtrace($e->getTrace()),
+            ]);
 
             if ($this->DBDebug) {
                 throw new DatabaseException($e->getMessage(), $e->getCode(), $e);

tests/system/Database/Live/ExecuteLogMessageFormatTest.php

@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of CodeIgniter 4 framework.
+ *
+ * (c) CodeIgniter Foundation <[email protected]>
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE file that was distributed with this source code.
+ */
+
+namespace CodeIgniter\Database\Live;
+
+use CodeIgniter\Test\CIUnitTestCase;
+use CodeIgniter\Test\DatabaseTestTrait;
+use CodeIgniter\Test\TestLogger;
+use Config\Database;
+use PHPUnit\Framework\Attributes\Group;
+
+/**
+ * @internal
+ */
+#[Group('DatabaseLive')]
+final class ExecuteLogMessageFormatTest extends CIUnitTestCase
+{
+    use DatabaseTestTrait;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+
+        $utils = Database::utils();
+        $forge = Database::forge();
+
+        foreach (['foobar', 'test_com.sitedb.web'] as $database) {
+            if ($utils->databaseExists($database)) {
+                $forge->dropDatabase($database);
+            }
+        }
+
+        $this->disableDBDebug();
+    }
+
+    protected function tearDown(): void
+    {
+        $this->enableDBDebug();
+
+        parent::tearDown();
+    }
+
+    public function testLogMessageWhenExecuteFailsShowFullStructuredBacktrace(): void
+    {
+        $sql = 'SELECT * FROM some_table WHERE id = ? AND status = ? AND author = ?';
+        $this->db->query($sql, [3, 'live', 'Rick']);
+
+        $message = match ($this->db->DBDriver) {
+            'MySQLi'  => 'Table \'test.some_table\' doesn\'t exist',
+            'Postgre' => 'pg_query(): Query failed: ERROR:  relation "some_table" does not exist',
+            'SQLite3' => 'Unable to prepare statement: no such table: some_table',
+            'OCI8'    => 'oci_execute(): ORA-00942: table or view does not exist',
+            'SQLSRV'  => '[Microsoft][ODBC Driver 18 for SQL Server][SQL Server]Invalid object name \'some_table\'. SQLSTATE: 42S02, code: 208',
+            default   => 'Unknown DB error',
+        };
+        $messageFromLogs = explode("\n", $this->getPrivateProperty(TestLogger::class, 'op_logs')[0]['message']);
+
+        $this->assertSame($message, array_shift($messageFromLogs));
+
+        if ($this->db->DBDriver === 'Postgre') {
+            $messageFromLogs = array_slice($messageFromLogs, 2);
+        } elseif ($this->db->DBDriver === 'OCI8') {
+            $messageFromLogs = array_slice($messageFromLogs, 1);
+        }
+
+        $this->assertMatchesRegularExpression('/^in \S+ on line \d+\.$/', array_shift($messageFromLogs));
+
+        foreach ($messageFromLogs as $line) {
+            $this->assertMatchesRegularExpression('/^\s*\d* .+(?:\(\d+\))?: \S+(?:(?:\->|::)\S+)?\(.*\)$/', $line);
+        }
+    }
+}

utils/phpstan-baseline/missingType.iterableValue.neon

@@ -1,4 +1,4 @@
-# total 1672 errors
+# total 1670 errors
 
 parameters:
     ignoreErrors:
@@ -2417,11 +2417,6 @@ parameters:
             count: 1
             path: ../../system/Debug/Exceptions.php
 
-        -
-            message: '#^Method CodeIgniter\\Debug\\Exceptions\:\:renderBacktrace\(\) has parameter \$backtrace with no value type specified in iterable type array\.$#'
-            count: 1
-            path: ../../system/Debug/Exceptions.php
-
         -
             message: '#^Method CodeIgniter\\Debug\\Exceptions\:\:respond\(\) has parameter \$data with no value type specified in iterable type array\.$#'
             count: 1