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 或客户端自身做轻量级预处理（例如忽略包围括号），从而“恰好”绕过了该问题，造成“凭据正确”的假象。
✅ 正确写法应避免任何非必要符号包裹：
[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() 值是最直接的验证方式。配置即代码，细微的格式差异足以导致认证失败。
