Laravel 8 查询阿拉伯语数据库记录返回空结果的解决方案咨询

核心失效原因定位 #

• 数据库/表/字段级字符集与排序规则不匹配
  存储阿拉伯语的字段若未配置适配的字符集（如使用utf8mb3、latin1、通用utf8_general_ci排序规则），会导致带变音符号的阿拉伯语特殊字符存储时被截断、识别错位，哪怕查询关键词和存储文本字面完全一致，也无法匹配到结果。
• 字符串归一化逻辑缺失
  阿拉伯语同一语义的词汇存在多种写法变体（如带/不带tashkeel变音、Hamza不同形态、Alif长短合字差异），如果不做统一归一化处理，直接用原生LIKE匹配原始字符串，会因为码点差异完全匹配失败。
• 第三方检索包调用方式错误
  原有代码中DB::raw('text',$strCondition,$strOrderBy)的写法存在语法硬伤：DB::raw仅支持传入单个字符串参数，后续传入的查询条件、排序规则参数根本不会被拼入最终执行的SQL，等于查询全程没有携带有效筛选条件，自然无法返回正确结果。

可直接落地的修复步骤 #

1. 修正数据库底层配置 #

先对verses表的字符集配置做统一校验和调整，执行原生SQL把表结构调整为适配阿拉伯语存储的配置：

-- 校验现有字段的排序规则
SHOW FULL COLUMNS FROM verses;
-- 把表结构转换为支持阿拉伯语的utf8mb4字符集
ALTER TABLE verses CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_arabic_ci;

调整完成后，直接运行原生SQL验证基础匹配能力：

SELECT text FROM verses WHERE text LIKE '%ٱللَّهِ%' LIMIT 10;

如果这步原生SQL能返回匹配结果，说明数据库层配置正常；如果依然返回空，说明历史写入的阿拉伯语语料本身存在编码丢失问题，需要重新导出原始无转义的阿拉伯语内容重新导入。

2. 修正Eloquent检索的归一化逻辑 #

不要直接用原始关键词做LIKE匹配，需要对查询关键词、数据库存储字段做统一的阿拉伯语字符归一化，剔除不影响语义的字符差异：

// 阿拉伯语文本归一化辅助函数
function normalizeArabic(string $text): string
{
    // 移除所有tashkeel变音符号
    $text = preg_replace('/[\x{064B}-\x{0652}]/u', '', $text);
    // 统一不同形态的Alif字符
    $text = str_replace(['ٱ', 'أ', 'إ', 'آ'], 'ا', $text);
    // 统一Ta Marbuta变体字符
    $text = str_replace('ة', 'ه', $text);
    return $text;
}

// 正确的查询写法
$keyword = normalizeArabic('ٱللَّهِ');
Verse::whereRaw(
    "REPLACE(REPLACE(REPLACE(REPLACE(text, '/[\x{064B}-\x{0652}]/u', ''), 'ٱ', 'ا'), 'أ', 'ا'), 'ة', 'ه') LIKE ?",
    ["%{$keyword}%"]
)->get();

3. 修正第三方阿拉伯语检索包的调用逻辑 #

调整原有错误的查询拼接方式，把生成的where条件、排序规则单独传入对应的查询构造器方法中，避免参数被丢弃：

$mode = "1";
$Arabic = new Arabic();
$Arabic->setQueryStrFields('text');
$Arabic->setQueryMode($mode);
$keyword = str_replace('\"', '"', $string);
$strCondition = $Arabic->arQueryWhereCondition($keyword);
$strOrderBy = $Arabic->arQueryOrderBy($keyword);

// 修正后的正确查询写法
$result = DB::table('verses')
    ->selectRaw('text')
    ->whereRaw($strCondition)
    ->orderByRaw($strOrderBy)
    ->limit(10)
    ->get();

调用过程中可以开启查询日志打印最终执行的SQL，确认生成的筛选条件是否真的被拼入查询语句，避免参数传递失效。

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