EF Core调用FromSqlRaw执行含CONTAINSTABLE和表值参数查询返回0行如何解决

问题原因 #

主要有3个核心错误导致查询返回0条数据：

1. 全文搜索不支持前导通配符
   SQL Server 的CONTAINSTABLE仅支持后缀通配符（比如"BACON*"），你写的"*BACON*"这种前后都带通配符的写法是无效的，全文检索会将开头的*识别为普通字符，无法匹配包含BACON的内容，自然返回空结果。
2. 参数使用不规范
   你使用{0}、{1}位置占位符传参时，EF Core会忽略你自定义的ParameterName，自动将参数重命名为@p0、@p1，虽然这种写法本身不会直接报错，但参数顺序调整时极易出问题。另外第二个搜索参数@produto_marca没有指定SqlDbType和长度，默认长度不足会导致搜索条件被截断，匹配不到结果。
3. 全文索引配置异常
   如果数据库中produto表的pesquisa列没有创建全文索引，或者全文索引的默认语言没有设置为巴西葡萄牙语，也会导致匹配不到结果。

解决方法 #

步骤1：修正全文搜索语法 #

如果你需要实现模糊匹配包含指定关键词的内容，有两个可选方案：

• 方案1（性能最优）：仅保留后缀通配符，符合全文搜索设计，将搜索条件改为( "BACON*" near "SALGADO*" near "ENROLADO*" )
• 方案2：如果必须实现前后模糊匹配，将全文搜索替换为LIKE语法（注意数据量大时性能较差）

步骤2：修正参数和SQL写法 #

直接在SQL中使用自定义参数名，同时补全搜索参数的类型配置：

// 修正搜索参数配置
SqlParameter param2 = new SqlParameter()
{
    ParameterName = "@produto_marca",
    SqlDbType = System.Data.SqlDbType.VarChar,
    Size = 2000, // 长度足够容纳最长的搜索条件
    Value = produtoMarca
};
// 修正SQL写法，直接使用参数名
var sql = @"SELECT TOP(40) p.id_produto AS IdProduto, p.nome AS Nome, fts.[rank] AS Rank 
FROM @produto AS p 
INNER JOIN CONTAINSTABLE(produto, pesquisa, @produto_marca, language N'BRAZILIAN') AS fts ON p.id_produto = fts.[key] 
WHERE ISNULL(fts.rank, 0) > 0 ORDER BY 3";
var nomesProdutoRanking = await _v1Context.NomesProdutoRanking.FromSqlRaw(sql, param, param2).ToListAsync();

步骤3：确认全文索引配置 #

在SSMS中执行以下语句检查全文索引是否正确配置：

-- 检查produto表是否有全文索引
SELECT * FROM sys.fulltext_indexes WHERE object_id = OBJECT_ID('produto')
-- 检查全文索引是否包含pesquisa列，且语言为巴西葡萄牙语（LCID 1046）
SELECT * FROM sys.fulltext_index_columns WHERE object_id = OBJECT_ID('produto')

如果没有配置全文索引，需要先创建对应全文目录和索引，指定语言为1046（巴西葡萄牙语）。

调试技巧 #

如果修改后还是返回空，可以开启EF Core日志输出，拿到实际生成的SQL语句和参数值，放到SSMS中直接执行，就能快速定位具体问题点。

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