.NET连接本地MariaDB Docker容器失败故障排查

针对你遇到的问题，以下是具体的排查方向：

1. 驱动版本与MariaDB兼容性检查 #

旧版本的MySql.Data.MySqlClient可能无法兼容新版MariaDB（如10.5及以上版本），容易出现协议解析或类型转换错误。

• 操作：
  • 查看项目中NuGet包MySql.Data的版本，升级至最新稳定版
  • 若升级后仍有问题，建议替换为官方推荐的MySqlConnector驱动（API兼容MySql.Data，对MariaDB支持更友好）

2. 优化连接字符串参数 #

连接字符串缺失关键参数可能导致驱动与数据库协商失败，引发类型转换错误。

• 尝试添加SslMode和字符集参数，调整后的连接字符串示例：

  server=127.0.0.1;port=3306;user id=brian;password=<PASS>;database=conciergedb;ConnectionTimeout=60;SslMode=None;CharSet=utf8mb4;
  

• 注意：若密码包含特殊字符（如&、;），需用双引号包裹或转义

3. 检查MariaDB初始化脚本与用户权限 #

初始化脚本中的异常定义或用户权限不足，可能导致驱动读取元数据时触发DBNull转换错误。

• 操作：
  • 检查./mariainit目录下的初始化脚本，确认是否存在默认值为NULL但驱动期望非空的字段定义
  • 在mysql命令行执行SHOW GRANTS FOR 'brian'@'%';，验证用户brian拥有conciergedb的完整操作权限（至少包含SELECT、INSERT、UPDATE等基础权限）

4. 调整MariaDB的网络配置参数 #

Docker日志中的Got an error reading communication packets提示，可能与数据包大小限制或超时设置有关。

• 在docker-compose的environment中添加以下配置，重启容器后重试：

  environment:
    # 原有配置不变，新增以下两行
    MARIADB_MAX_ALLOWED_PACKET: 64M
    MARIADB_WAIT_TIMEOUT: 600
  

5. 排查WSL与Docker的网络上下文差异 #

虽然命令行和Workbench能正常连接，但.NET程序的网络运行环境可能不同：

• 若.NET程序运行在Windows系统上，尝试用host.docker.internal替换127.0.0.1作为服务器地址
• 若.NET程序运行在WSL内，执行ping 10.5.0.3和telnet 10.5.0.3 3306验证网络连通性，确保WSL能访问容器的静态IP

6. 捕获驱动详细日志 #

InvalidCastException可能是内部解析错误，开启驱动日志可定位具体环节：

• 在连接字符串中添加日志参数（需驱动版本支持）：

  server=127.0.0.1;...;Log=true;LogPath=mysql_connection.log;
  

• 查看生成的日志文件，分析连接过程中哪个步骤触发了DBNull类型转换

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