Laravel连接IBM DB2遇PDOException：用户名/密码无效求助

我尝试用Laravel连接IBM DB2数据库，出现PDOException错误提示“用户名和/或密码无效”，但相同的账号密码在DBeaver里能正常连接。用Postman发POST请求测试连接时，报错如下：

PDOException: SQLSTATE=08001, SQLDriverConnect: -30082 [IBM][CLI Driver] SQL30082N Security processing failed with reason "24" ("USERNAME AND/OR PASSWORD INVALID"). SQLSTATE=08001

配置文件示例 #

database.php #

'ibm_db2' => [
    'driver' => 'db2_ibmi_ibm',
    // or 'db2_ibmi_ibm' / 'db2_zos_odbc' / 'db2_expressc_odbc / 'db2_ibmi_odbc'
    'driverName' => '{IBM i Access ODBC Driver}',
    // or '{iSeries Access ODBC Driver}' / '{IBM i Access ODBC Driver 64-bit}'
    'host' => '173.24.3.21',
    'username' => 'username1',
    'password' => 'supercoolPassword3D7E=AG`:6c',
    'database' => 'database1',
    'prefix' => '',
    'schema' => 'default schema',
    'port' => 50003,
    'date_format' => 'Y-m-d H:i:s',
    // or 'Y-m-d H:i:s.u' / 'Y-m-d-H.i.s.u'...
    'odbc_keywords' => [
        'SIGNON' => 3,
        'SSL' => 0,
        'CommitMode' => 2,
        'ConnectionType' => 0,
        'DefaultLibraries' => '',
        'Naming' => 0,
        'UNICODESQL' => 0,
        'DateFormat' => 5,
        'DateSeperator' => 0,
        'Decimal' => 0,
        'TimeFormat' => 0,
        'TimeSeparator' => 0,
        'TimestampFormat' => 0,
        'ConvertDateTimeToChar' => 0,
        'BLOCKFETCH' => 1,
        'BlockSizeKB' => 32,
        'AllowDataCompression' => 1,
        'CONCURRENCY' => 0,
        'LAZYCLOSE' => 0,
        'MaxFieldLength' => 15360,
        'PREFETCH' => 0,
        'QUERYTIMEOUT' => 1,
        'DefaultPkgLibrary' => 'QGPL',
        'DefaultPackage' => 'A /DEFAULT(IBM),2,0,1,0',
        'ExtendedDynamic' => 0,
        'QAQQINILibrary' => '',
        'SQDIAGCODE' => '',
        'LANGUAGEID' => 'ENU',
        'SORTTABLE' => '',
        'SortSequence' => 0,
        'SORTWEIGHT' => 0,
        'AllowUnsupportedChar' => 0,
        'CCSID' => 819,
        'GRAPHIC' => 0,
        'ForceTranslation' => 0,
        'ALLOWPROCCALLS' => 0,
        'DB2SQLSTATES' => 0,
        'DEBUG' => 0,
        'TRUEAUTOCOMMIT' => 0,
        'CATALOGOPTIONS' => 3,
        'LibraryView' => 0,
        'ODBCRemarks' => 0,
        'SEARCHPATTERN' => 1,
        'TranslationDLL' => '',
        'TranslationOption' => 0,
        'MAXTRACESIZE' => 0,
        'MultipleTraceFiles' => 1,
        'TRACE' => 0,
        'TRACEFILENAME' => '',
        'ExtendedColInfo' => 0,
    ],
    'options' => [
        PDO::ATTR_CASE => PDO::CASE_LOWER,
        PDO::ATTR_PERSISTENT => false
    ]
    // + (defined('PDO::I5_ATTR_DBC_SYS_NAMING') ? [PDO::I5_ATTI5_ATTR_DBC_SYS_NAMINGR_COMMIT => false] : [])
    // + (defined('PDO::I5_ATTR_COMMIT') ? [PDO::I5_ATTR_COMMIT => PDO::I5_TXN_NO_COMMIT] : [])
    // + (defined('PDO::I5_ATTR_JOB_SORT') ? [PDO::I5_ATTR_JOB_SORT => false] : [])
    // + (defined('PDO::I5_ATTR_DBC_LIBL') ? [PDO::I5_ATTR_DBC_LIBL => ''] : [])
    // + (defined('PDO::I5_ATTR_DBC_CURLIB') ? [PDO::I5_ATTR_DBC_CURLIB => ''] : [])
],

.env #

DB_CONNECTION=ibm_db2
DB_HOST=173.24.3.21
DB_PORT=50003
DB_DATABASE=database1
DB_USERNAME=username1
DB_PASSWORD="supercoolPassword3D7E=AG`:6c"

目前发现Laravel似乎没有读取.env文件，修改该文件无任何效果；修改database.php会触发不同的错误。

排查解决办法 #

1. 强制刷新Laravel配置缓存 #

Laravel会缓存配置文件，修改.env后未清缓存会继续使用旧配置，执行以下命令：

php artisan config:clear
php artisan cache:clear
# 生产环境可执行下面的命令重新缓存配置
# php artisan config:cache

2. 修复.env文件的密码格式 #

你的密码包含=、:、`等特殊字符，.env中不需要加双引号（否则引号会被当成密码的一部分），修改为：

DB_PASSWORD=supercoolPassword3D7E=AG`:6c

若特殊字符导致解析异常，改用单引号包裹：

DB_PASSWORD='supercoolPassword3D7E=AG`:6c'

3. 验证Laravel是否正确读取.env参数 #

在路由中临时添加代码，输出当前数据库配置，确认参数是否匹配：

// 在routes/api.php或web.php中添加
Route::get('/check-db-config', function () {
    dd([
        'connection' => config('database.default'),
        'username' => config('database.connections.ibm_db2.username'),
        'password' => config('database.connections.ibm_db2.password'),
        'host' => config('database.connections.ibm_db2.host'),
    ]);
});

访问该路由，查看输出的密码是否和设置一致，排除配置读取问题。

4. 修改database.php引用.env变量 #

你当前的database.php是硬编码的账号密码，所以修改.env不会生效，必须改为用env()函数读取：

'ibm_db2' => [
    'driver' => 'db2_ibmi_ibm',
    'driverName' => '{IBM i Access ODBC Driver}',
    'host' => env('DB_HOST'),
    'username' => env('DB_USERNAME'),
    'password' => env('DB_PASSWORD'),
    'database' => env('DB_DATABASE'),
    'port' => env('DB_PORT'),
    // 保留其他原有配置
],

5. 检查ODBC驱动版本和位数 #

确认Laravel运行环境使用的ODBC驱动和DBeaver一致（同32位/64位），驱动不匹配可能导致认证失败。可通过以下命令查看当前ODBC配置：

odbcinst -j

对比DBeaver的驱动设置，确保版本、位数一致。

6. 直接测试ODBC连接有效性 #

用ODBC命令行工具测试连接，排除Laravel层面问题：

isql -v "{IBM i Access ODBC Driver}" username1 supercoolPassword3D7E=AG`:6c 173.24.3.21:50003

若命令行连接失败，说明是ODBC配置问题；若成功，再回到Laravel排查配置读取逻辑。

7. 调整密码字符编码设置 #

IBM i用户密码有特定编码要求，可尝试修改database.php中odbc_keywords的CCSID参数，设置为1208（UTF-8）或与DBeaver使用的编码一致。

8. 清除无效持久连接 #

若之前有错误的持久连接残留，可重启PHP-FPM或Web服务器，清除旧会话。

内容的提问来源于stack exchange，提问作者Jo Amon