Power BI连接MySQL报错:Value 'preferred'类型不正确,求排查方案
解决Power BI连接MySQL时"Value 'preferred' is not of the correct type"报错
这个报错大概率是连接参数类型不匹配或者连接器/环境配置冲突导致的,结合你已经重装过Power BI的情况,我整理了几个最可能的根源和对应的解决步骤:
1. 连接器版本与环境不兼容
这是最常见的原因:
- 首先确认你安装的是对应位数的Power BI MySQL连接器:Power BI分32位和64位,连接器必须和Power BI位数完全一致(比如64位Power BI要装64位的MySQL连接器),混装会导致参数解析异常。
- 其次检查连接器与MySQL服务器版本的匹配性:比如MySQL 8.0+需要使用支持
caching_sha2_password认证的连接器,而旧版连接器可能不兼容;如果你的MySQL是5.x版本,建议降级到对应版本的Power BI连接器(不要用最新版)。
2. ODBC数据源配置的参数类型错误
Power BI的MySQL连接器底层依赖ODBC,可能是你手动输入了错误的参数值:
- 打开对应位数的「ODBC数据源管理器」:
- 64位:
C:\Windows\System32\odbcad32.exe - 32位:
C:\Windows\SysWOW64\odbcad32.exe
- 64位:
- 找到你的MySQL数据源,进入配置界面,检查SSL模式等下拉选项:不要手动输入
preferred字符串,而是选择下拉菜单里的标准选项(比如Disabled、Required),因为下拉选项对应的是枚举值,手动输入的字符串类型不符合连接器的参数要求,就会触发这个报错。
3. Power BI连接的高级参数设置错误
如果在Power BI连接界面的「高级」选项里添加了自定义参数,可能是参数值不符合要求:
- 打开Power BI的MySQL连接窗口,点击「高级」,检查额外连接参数里是否有类似
ssl-mode=preferred的配置。 - 部分Power BI MySQL连接器版本不支持
preferred这个SSL模式值,建议改成ssl-mode=REQUIRED(强制SSL)或者ssl-mode=DISABLED(禁用SSL),保存后重新尝试连接。
4. 残留配置干扰(重装未清理干净)
虽然你重装了Power BI,但可能残留的旧配置文件/注册表项还在干扰:
- 卸载Power BI后,手动删除以下目录:
C:\Program Files\Microsoft Power BI Desktop%USERPROFILE%\AppData\Local\Microsoft\Power BI Desktop
- (可选)用微软的「Program Install and Uninstall Troubleshooter」工具清理残留的注册表项(操作前建议备份注册表),然后重新安装Power BI和对应版本的连接器。
额外排查点:MySQL服务器SSL配置
如果你的MySQL服务器开启了强制SSL连接,但客户端连接器的SSL模式设置为preferred(仅尝试SSL,不强制),服务器可能返回参数类型不匹配的错误。可以登录MySQL服务器,执行以下命令检查SSL配置:
SHOW VARIABLES LIKE '%ssl%';
如果require_secure_transport设置为ON,则需要将Power BI的SSL模式改为REQUIRED才能正常连接。
内容的提问来源于stack exchange,提问作者nat_nut




