ASP.NET Core 5.0+EF查询报错：CAST/CONVERT指定bit类型属性无效

问题分析 #

从捕获的SQL语句可以看到，EF Core生成了CAST(1 AS bit(1))这类语法，但SQL Server的bit类型不需要指定长度（bit(1)是错误写法，正确应为CAST(1 AS bit)），这直接导致了转换错误。

解决方案 #

1. 升级EF Core版本 #

EF Core 5.0的部分早期版本存在该bit类型转换的bug，建议升级到EF Core 5.0的最新补丁版本（如5.0.17），或者直接升级至更高稳定版本（如EF Core 6.0/7.0），官方后续版本已修复这类SQL生成逻辑问题。

2. 调整LINQ查询的布尔条件写法 #

将查询中的布尔隐式判断改为显式比较true，可能会改变EF生成的SQL逻辑：

var response = EntityContext.Include(x => x.UserRoles)
                    .ThenInclude(x => x.Role)
                    .ThenInclude(x => x.RolePermissions)
                    .ThenInclude(x => x.Permission)
                    .Where(x => x.Email == email && x.IsVerified == true && x.IsActive == true)
                    .SingleOrDefault();

3. 验证实体类与数据库字段的类型匹配 #

检查实体类中IsVerified和IsActive属性是否定义为bool类型，同时确认数据库中对应列是bit类型，避免通过Fluent API或Data Annotation错误指定带长度的bit类型（比如HasColumnType("bit(1)")）。若有错误配置，修正为：

// Fluent API示例
modelBuilder.Entity<User>()
    .Property(u => u.IsVerified)
    .HasColumnType("bit");

4. 临时替代方案（不推荐大数据量场景） #

若上述方法暂时无法生效，可调整查询顺序，先执行筛选再关联查询，确保筛选逻辑在数据库端执行：

var response = EntityContext.User
                    .Where(x => x.Email == email && x.IsVerified && x.IsActive)
                    .Include(x => x.UserRoles)
                    .ThenInclude(x => x.Role)
                    .ThenInclude(x => x.RolePermissions)
                    .ThenInclude(x => x.Permission)
                    .SingleOrDefault();

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