MariaDB连接失败：配置文件中括号被误读为密码一部分的排查与修复-Python教程-PHP中文网

mariadb连接失败：配置文件中括号被误读为密码一部分的排查与修复

Python通过mariadb驱动连接MariaDB时出现“Access denied”错误，但命令行能正常登录，根本原因常是配置文件中密码被意外包裹了括号（如password = (mypassword)），导致Python原样读取并提交含括号的错误密码。

mariadb连接失败：配置文件中括号被误读为密码一部分的排查与修复

在使用 mariadb Python 驱动连接 MariaDB 时，遇到 OperationalError: Access denied for user 'myuser'@'myhost.local' (using password: YES) 是一个典型且易被忽视的问题——尤其当命令行（如 mariadb -u ... -p...）能成功连接，而 Python 脚本却持续失败时。

根本原因往往并非权限或网络问题，而是配置文件解析异常。正如案例所示：用户在 dbconfig.ini 中将密码写为：

[DEFAULT]
username = myuser
password = (secret123)  # ❌ 错误：括号被当作密码字面量的一部分！
server = db.example.com
port = 3306
database = mydb

configparser 默认不会自动剥离括号、引号或空格——它严格按INI语法读取值。因此 config_default['password'] 实际返回的是字符串 "(secret123)"（含左右括号），而非预期的 "secret123"。而命令行客户端（如 mariadb CLI）在解析 -p(secret123) 参数时，会由 shell 或客户端自身做轻量级预处理（例如忽略包围括号），从而“恰好”绕过了该问题，造成“凭据正确”的假象。

✅ 正确写法应避免任何非必要符号包裹：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

[DEFAULT]
username = myuser
password = secret123      # ✅ 纯文本，无空格、无括号、无引号
server = db.example.com
port = 3306
database = mydb

⚠️ 补充注意事项：

configparser 对值首尾空白默认不自动 strip（除非启用 interpolation=None 并手动处理），建议在读取后显式清理：
```
password = config_default.get('password', '').strip()
```
若密码必须含特殊字符（如 @, $, %），INI 文件中无需转义，但需确保未被其他工具（如 IDE 自动格式化）意外修改；

启用日志可快速验证实际传入的凭据：

print(f"Connecting as: {config_default['username']}@{config_default['server']}")
print(f"Password length: {len(password)}, repr: {repr(password)}")  # 查看真实字节

? 总结：当 Python 连接失败而 CLI 成功时，请优先检查 configparser 读取的凭证是否与预期完全一致——打印 repr() 值是最直接的验证方式。配置即代码，细微的格式差异足以导致认证失败。