Excel VBA连接MySQL报Error1004，手动取数正常、原MSSQL连接正常

基于已知场景判定：手动操作可正常拉取MySQL数据，说明网络连通性、驱动安装、数据库账号权限、Excel宏安全策略不存在基础问题；此前连接MSSQL功能完全正常，说明VBA运行的基础环境无损坏，1004报错本质是VBA调用数据库对象时的参数匹配、引用配置、残留配置冲突导致，和底层连通性无关。

分步骤定位解决 #

• 驱动引用与版本匹配问题排查
  此前连接MSSQL时，VBA工程默认引用SQL Server生态的相关驱动库，切换MySQL时如果没有同步调整引用配置，会直接触发对象识别失败的1004报错。操作校验：按下Alt+F11打开VBA编辑器，进入「工具-引用」面板，逐一核对：
  • 当前VBA工程引用的驱动版本，和手动连接MySQL时使用的驱动版本完全一致，不要错勾ANSI版本的同系列旧驱动
  • 清除残留的SQL Server专用驱动的无效引用，这类残留引用会抢占对象解析优先级，导致VBA无法正确调用MySQL驱动接口
• 手写连接串参数不兼容问题排查
  手动连接时Excel会自动协商匹配连接参数（比如SSL模式、字符集、端口解析规则），但VBA通过ADODB对象发起连接时不会做自动适配，手写参数缺漏就会初始化失败。常见踩坑点：
  • 照搬MSSQL的连接串格式：MSSQL的端口是拼接在服务器地址后（格式为Server=xxx,1433），但MySQL ODBC连接的端口是独立参数Port=3306，格式混写会直接触发参数解析失败
  • 漏写必要适配参数：MySQL8.0以上版本默认开启强制SSL校验，VBA连接时如果没加SSLMode=0关闭非必要的强校验，会出现连接协商失败；如果没加Charset=utf8mb4匹配数据库字符集，也会触发对象初始化报错
  • 可直接复用的MySQL ODBC连接串参考：Driver={MySQL ODBC 8.0 Unicode Driver};Server=你的数据库地址;Port=3306;Database=目标库名;User=数据库账号;Password=数据库密码;Option=3;Charset=utf8mb4;SSLMode=0;
• 旧连接残留配置冲突排查
  此前连接MSSQL时，Excel会在本地留存多份连接配置（存储在「数据-现有连接」列表、工作表的查询缓存中），如果VBA代码直接复用这些残留的Connection对象实例，哪怕手动修改了连接地址，底层连接的提供程序还是旧的MSSQL驱动，就会触发1004。操作调整：VBA取数逻辑里不要引用工作表内置的旧连接对象，每次执行时新建独立的ADODB.Connection实例，手动给ConnectionString属性赋值；执行前清空所有本地存储的MSSQL旧连接配置，避免缓存干扰。
• 系统驱动位数不匹配排查
  手动连接时Excel会通过系统兼容层适配不同位数的驱动，但VBA是直接调用系统原生驱动接口，不会做兼容转发。校验方式：核对Excel安装位数和MySQL ODBC驱动的安装位数完全一致，比如64位Excel必须安装64位版本的MySQL ODBC驱动，不能混用32位驱动。

快速验证技巧：把ODBC数据源测试通过的连接串完整复制到VBA代码中，不要凭借记忆手写拼接参数，可覆盖80%以上的参数类1004报错。

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