使用EF与.NET6操作Firebird数据库查询时遇-204错误求助

架构老林

2026-7-26

问题原因及解决方案

这个错误（SQL error code = -204）是Firebird的动态SQL块大小超过实现限制导致的，和你调整字段长度无关。核心原因是EF生成的SQL中，对Nome和Apelido调用ToLower()后再做StartsWith，会生成复杂的字符串处理表达式，导致动态SQL体积超出Firebird的限制阈值。

解决办法：

优化查询逻辑，避免在实体属性上调用ToLower()
先将输入参数转为小写，直接在StartsWith中使用，让EF生成更简洁的SQL：
```
public async Task<Operadora> ObterPorNome(string nome, string apelido)
{
    var lowerNome = nome.ToLower();
    var lowerApelido = apelido.ToLower();
    
    return await _db.Set<Operadora>()
        .Where(c => c.Nome.StartsWith(lowerNome) || c.Apelido.StartsWith(lowerApelido))
        .FirstOrDefaultAsync();
}
```
同时确保Firebird数据库的字段排序规则设置为不区分大小写（比如使用UNICODE_CI或UTF8_CI排序规则），这样就能实现不区分大小写的前缀匹配，无需在SQL中做额外的大小写转换。

改用Firebird原生的不区分大小写匹配函数
如果无法修改排序规则，可以使用Firebird的ILIKE操作符，通过EF的EF.Functions调用：

public async Task<Operadora> ObterPorNome(string nome, string apelido)
{
    var nomePattern = $"{nome}%";
    var apelidoPattern = $"{apelido}%";
    
    return await _db.Set<Operadora>()
        .Where(c => EF.Functions.ILike(c.Nome, nomePattern) || EF.Functions.ILike(c.Apelido, apelidoPattern))
        .FirstOrDefaultAsync();
}

这种方式生成的SQL更简洁，不会触发块大小超限的问题，同时原生支持不区分大小写匹配。

检查Firebird版本和EF Provider版本
如果你使用的是Firebird 2.x及更早版本，建议升级到Firebird 3.0+，新版本放宽了动态SQL块大小的限制。同时确保使用最新版本的FirebirdSql.EntityFrameworkCore.Firebird NuGet包，旧版本可能存在SQL生成的bug。