ASP.NET Core+EF Core操作MariaDB删除数据时SQL语法错误

问题分析 #

你遇到的RETURNING 1是EF Core为获取操作受影响行数自动生成的语法，但Pomelo.EntityFrameworkCore.MySql在特定版本或配置下，对MariaDB 11.x的RETURNING语法适配出现异常，导致SQL执行失败。

解决思路 #

1. 确保Pomelo与MariaDB版本兼容 #

• 检查Pomelo.EntityFrameworkCore.MySql的版本，确保它与你的EF Core版本匹配，且支持MariaDB 11.2.2。建议升级到对应EF Core版本的最新稳定Pomelo包（比如EF Core 8对应Pomelo 8.x系列），新版本对高版本MariaDB的语法支持更完善。

2. 显式指定MariaDB版本配置 #

在你的IrtsContext的OnConfiguring方法中，明确指定MariaDB版本，让Pomelo生成适配的SQL语法：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseMySql(
        "你的数据库连接字符串",
        new MySqlServerVersion(new Version(11, 2, 2)), // 匹配你的MariaDB版本
        options => options.EnableRetryOnFailure() // 可选，按需添加
    );
}

3. 改用无跟踪的批量删除方法 #

避免先查询实体再删除的方式，直接使用ExecuteDeleteAsync生成简洁SQL，绕过RETURNING语法问题：

修改仓储删除方法：

public async Task DeleteAlertAsync(int alertId)
{
    var affectedCount = await _alertContext.Alerts
        .Where(a => a.AlertId == alertId)
        .ExecuteDeleteAsync();

    if (affectedCount == 0)
    {
        throw new KeyNotFoundException("Alert not found");
    }
}

对应的控制器代码调整（修复路由参数问题）：

[HttpDelete("{alertId}")] // 原路由"alertId"会被识别为固定路径，需改为{alertId}接收参数
public async Task<IActionResult> DeleteAlert(int alertId)
{
    try
    {
        await _dataRepository.DeleteAlertAsync(alertId);
        return NoContent();
    }
    catch (KeyNotFoundException)
    {
        return NotFound("Alert not found");
    }
}

4. 直接执行原生SQL删除 #

如果上述方法仍有问题，可直接执行原生SQL完全控制语句内容：

public async Task DeleteAlertAsync(int alertId)
{
    var affectedCount = await _alertContext.Database
        .ExecuteSqlRawAsync("DELETE FROM Alerts WHERE AlertId = {0}", alertId);

    if (affectedCount == 0)
    {
        throw new KeyNotFoundException("Alert not found");
    }
}

额外检查 #

• 确认Alert实体的主键配置正确，EF Core需要明确主键才能生成正确的删除语句。
• 开启EF Core日志查看生成的完整SQL，手动在数据库执行验证是否为MariaDB版本不支持该RETURNING写法。

内容的提问来源于stack exchange，提问作者Wolf at the Doors