Ubuntu下配置SSL加密MySQL ODBC连接报错故障排查问询

故障可能原因 #

• 配置文件语法错误：odbc.ini开头多余的RemoteConn= MySQL Unicode属于无效配置，会干扰DSN参数解析；SSL相关参数大小写、拼写不符合MySQL 8.x ODBC驱动的要求，或同时配置sslca和sslcapath触发路径校验冲突
• 证书权限不足：执行连接测试的用户无SSL证书文件的读取权限，或无证书上级目录的进入权限
• 基础连通性故障：远程数据库3306端口被防火墙/安全组拦截、数据库服务未开启SSL、数据库账号未授权当前服务器IP访问
• 管理器兼容性问题：iodbc对MySQL 8.x版本ODBC驱动的适配性较差，易出现无明确报错的连接失败问题

解决操作步骤 #

1. 修正配置文件
   删除odbc.ini开头多余的RemoteConn= MySQL Unicode行，调整[RemoteConn]块的SSL参数：删除sslcapath配置（已指定sslca具体路径时无需配置该参数），将sslVerify替换为SSL_VERIFY_SERVER_CERT=1，SSLMODE替换为ssl_mode=REQUIRED，避免参数识别异常。
2. 校验证书权限
   执行以下命令确认运行连接测试的用户对证书有访问权限：

   # 检查目录权限
   namei -l /home/gzappy/RemoteConnCerts/ca-cert.pem
   # 权限不足时执行授权（按需调整所属用户和权限范围）
   chmod o+rx /home/gzappy/RemoteConnCerts
   chmod o+r /home/gzappy/RemoteConnCerts/*.pem
   

3. 验证基础连接能力
   先用MySQL命令行工具验证SSL连通性，排除数据库侧配置问题：

   mysql -h [你的远程数据库IP] -u [数据库用户名] -p \
   --ssl-ca=/home/gzappy/RemoteConnCerts/ca-cert.pem \
   --ssl-cert=/home/gzappy/RemoteConnCerts/client-cert.pem \
   --ssl-key=/home/gzappy/RemoteConnCerts/client-key.pem
   

   若命令行连接失败，先排查数据库端的账号授权、SSL配置、端口放行规则。
4. 更换适配性更好的ODBC管理器
   卸载iodbc，安装unixODBC后测试连接，unixODBC的报错提示更清晰，对MySQL驱动的兼容性更好：

   # Debian/Ubuntu系操作
   apt remove -y iodbc libiodbc2
   apt install -y unixodbc unixodbc-dev
   # 测试连接命令
   isql -v RemoteConn
   

5. 开启日志定位问题
   若上述操作后仍连接失败，在odbc.ini的[RemoteConn]块中添加日志配置：

   Trace=Yes
   TraceFile=/tmp/odbc_trace.log
   MYSQL_OPT_DEBUG=d:t:O,/tmp/mysql_odbc.log
   

   重新执行连接测试后查看日志文件中的具体报错，即可精准定位根因。

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