Laravel自定义加密数据库列后WHERE（含LIKE）查询失效解决

问题根源 #

你通过模型访问器/修改器实现的加密逻辑，仅在模型实例存取数据阶段生效：存入时自动加密，取出时自动解密。但执行WHERE/LIKE查询时，是直接对数据库中存储的加密后字符串进行匹配，而你传入的是明文，自然无法匹配到结果。

可行解决方案 #

1. 精确查询：加密查询值后再匹配

如果只需要精确匹配，把要搜索的明文先通过你的自定义加密函数加密，再用加密后的字符串去匹配数据库字段：

// 要查询的明文内容
$target = '需要精确匹配的内容';
// 加密查询值
$encryptedTarget = Crypto::EncryptData($target);
// 执行精确查询
$results = YourModel::where('item', $encryptedTarget)->get();

注意：此方法仅适用于精确匹配，因为加密后的字符串是无规律的密文，明文的部分匹配（比如LIKE）无法对应到加密后的内容。

2. 模糊查询：新增冗余索引字段（推荐）

要实现模糊查询，必须在数据库中新增一个冗余字段（比如item_search_index），用来存储明文的特征信息（非完整明文，避免敏感数据泄露），比如关键词、前缀、脱敏后的内容等。

修改模型的修改器，同时设置加密字段和索引字段：

public function setItemAttribute($value) {
    $this->attributes['item'] = Crypto::EncryptData($value);
    // 示例：存储明文的小写前缀（可根据业务调整为关键词、拼音首字母等）
    $this->attributes['item_search_index'] = strtolower(substr($value, 0, 15));
}

查询时直接用索引字段做LIKE匹配：

$searchKeyword = '模糊查询的关键词';
$results = YourModel::where('item_search_index', 'like', "%{$searchKeyword}%")->get();

选型建议：索引字段的内容需结合业务场景设计，核心是平衡查询需求与数据安全，绝对不能存储完整明文。

3. 小数据量场景：应用层过滤

如果数据表数据量极小（比如几百条），可以先拉取所有数据到应用层，再用PHP进行过滤：

$searchTerm = '要模糊匹配的内容';
// 拉取所有模型实例（自动解密item字段）
$allRecords = YourModel::all();
// 用集合过滤匹配结果
$filteredRecords = $allRecords->filter(function ($record) use ($searchTerm) {
    return str_contains($record->item, $searchTerm);
});

缺点：数据量大时性能极差，会占用大量内存和数据库带宽，仅适合小数据集场景。

4. 数据库层面解密查询（不推荐）

部分数据库支持内置加密解密函数（比如MySQL的AES_ENCRYPT/AES_DECRYPT），可以直接在查询语句中解密字段后匹配，但存在两个核心问题：

• 性能极低：需要对每条记录解密后再匹配，无法利用索引，大数据量下完全不可用；
• 密钥一致性：必须保证数据库加密密钥与你Laravel自定义加密函数的密钥完全一致，否则解密失败。

示例（MySQL）：

$searchTerm = '查询内容';
$results = YourModel::whereRaw("AES_DECRYPT(item, '你的加密密钥') LIKE ?", ["%{$searchTerm}%"])->get();

注意：此方法仅作为最后备选，除非你能接受性能损失且密钥管理可控。

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