Windows11下Rust/Diesel+MySQL执行迁移报错：unsupported buffer type

环境信息 #

• Rust版本：rustc 1.75.0 (82e1608df 2023-12-21)
• MySQL版本：8.0.36 (MySQL Community Server)（曾尝试8.3.0）
• 执行命令：diesel setup / diesel migration run
• 报错信息：

  Using unsupported buffer type: 253  (parameter: 1)
  

• 迁移文件up.sql内容：

  CREATE TABLE categories (
    id INTEGER PRIMARY KEY NOT NULL AUTO_INCREMENT,
    name TEXT NOT NULL,
  );
  

• Cargo.toml核心配置：

  [dependencies]
  diesel = { version = "2.1.0", features = ["mysql", "chrono"] }
  diesel_migrations = "2.1.0"
  rocket_db_pools = { version = "0.1.0", features = ["diesel_mysql"] }
  

排查与解决方向 #

1. 确保Diesel CLI与依赖版本一致 #

Diesel CLI版本必须和项目中依赖的Diesel版本完全匹配，否则会出现兼容性问题：

• 执行diesel --version查看当前CLI版本
• 若版本不符，重新安装对应版本的CLI：

  cargo install diesel_cli --version 2.1.0 --no-default-features --features mysql
  

2. 清理MySQL客户端库冲突 #

Windows下多个MySQL/MariaDB环境会导致libmysql.dll版本冲突，按以下步骤操作：

• 卸载多余的数据库环境（如XAMPP的MariaDB），只保留MySQL Community Server
• 将MySQL的bin目录（如C:\Program Files\MySQL\MySQL Server 8.0\bin）添加到系统PATH最前端，确保优先加载正确版本的DLL
• 重启终端后重新执行迁移命令

3. 修正迁移文件SQL语法 #

迁移文件中列定义末尾存在多余逗号，MySQL会判定为语法错误，修正up.sql：

CREATE TABLE categories (
  id INTEGER PRIMARY KEY NOT NULL AUTO_INCREMENT,
  name TEXT NOT NULL
);

4. 检查数据库连接字符串 #

确认.env文件中的DATABASE_URL格式正确，示例：

DATABASE_URL=mysql://root:your_password@localhost/budget

• 确保用户名、密码正确，且数据库budget已存在（若不存在，可手动创建后再执行迁移）

5. 尝试降级Diesel版本 #

若上述方法无效，可尝试降级Diesel版本到2.0.x，修改Cargo.toml：

[dependencies]
diesel = { version = "2.0.6", features = ["mysql", "chrono"] }
diesel_migrations = "2.0.6"

然后重新安装对应版本的Diesel CLI：

cargo install diesel_cli --version 2.0.6 --no-default-features --features mysql

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