Laravel/React应用新增数据库列转换姓名格式适配搜索功能

1. 数据库层调整 #

首先给存储CSV数据的业务表新增标准化姓名字段，记得加索引优化搜索性能，直接通过Laravel迁移实现：

// 先执行命令生成迁移文件：php artisan make:migration add_name_normalized_to_{你的表名}_table --table={你的表名}
public function up()
{
    Schema::table('{你的表名}', function (Blueprint $table) {
        // 放在原姓名字段后面，建普通索引
        $table->string('name_normalized', 255)->after('{你的原始姓名字段键名}')->index();
    });
}

写完迁移执行php artisan migrate完成字段添加。

2. CSV导入逻辑修改 #

在原有updateOrCreate的处理逻辑里，加一步姓名格式转换，把「姓,名」格式转成「名 姓」存入新字段，注意处理多余空格和异常格式兜底：

// 遍历CSV每行数据时，先处理姓名字段
$originalName = $row['{CSV里姓名字段对应的列键名}'];
// 按逗号拆分，每段去掉前后空格
$nameSegments = array_map('trim', explode(',', $originalName));

// 只有符合「姓,名」两段结构的才做格式转换，其余格式直接存去空格后的原值兜底
if (count($nameSegments) === 2) {
    $normalizedName = trim($nameSegments[1] . ' ' . $nameSegments[0]);
} else {
    $normalizedName = trim($originalName);
}

// 代入原有updateOrCreate逻辑
YourModel::updateOrCreate(
    // 你原来写的唯一标识匹配条件，比如['user_code' => $row['user_code'], 'email' => $row['email']]
    $uniqueCondition,
    array_merge($otherFieldValues, [
        '{原始姓名字段键名}' => $originalName,
        'name_normalized' => $normalizedName
    ])
);

历史数据兼容 #

之前已经导入的老数据需要批量刷一遍标准化字段值，可以写个一次性artisan命令或者临时路由执行以下逻辑，跑完删掉临时路由就行：

YourModel::chunkById(100, function ($records) {
    $records->each(function ($item) {
        $nameSegments = array_map('trim', explode(',', $item->{原始姓名字段键名}));
        $normalized = count($nameSegments) === 2
            ? trim($nameSegments[1] . ' ' . $nameSegments[0])
            : trim($item->{原始姓名字段键名});
        $item->update(['name_normalized' => $normalized]);
    });
});

3. 搜索逻辑调整 #

不要只匹配原始姓名字段，同时匹配原始字段和标准化字段，统一处理用户输入的特殊字符，不管用户输入「Smith, John」还是「John Smith」都能命中：

public function search(Request $request)
{
    $keyword = trim($request->input('keyword', ''));
    // 把用户输入里的逗号替换成空格，合并连续空格，生成统一的搜索关键词
    $searchKeyword = preg_replace('/\s+/', ' ', str_replace(',', ' ', $keyword));

    $list = YourModel::where(function ($query) use ($keyword, $searchKeyword) {
        $query->where('{原始姓名字段键名}', 'LIKE', "%{$keyword}%")
            ->orWhere('name_normalized', 'LIKE', "%{$searchKeyword}%")
            ->orWhere('name_normalized', 'LIKE', "%{$keyword}%");
    })
    // 其他你原有的搜索条件
    ->paginate(20);

    return response()->json($list);
}

4. 前端React适配 #

原有字段映射逻辑不需要大改，只需要在姓名渲染列里按需选择展示格式即可，其他字段的渲染逻辑完全不受影响：

// 表格列配置示例
const columns = [
  // 其余业务字段列保持原有配置不变
  {
    title: '姓名',
    dataIndex: 'name',
    key: 'name',
    render: (_, record) => {
      // 按业务需求选展示格式：要保留原「姓,名」就取原始字段，要「名 姓」就取name_normalized
      return record.{原始姓名字段键名} || record.name_normalized;
    }
  }
];

注意事项 #

• 所有姓名处理环节必须加trim，避免CSV里逗号前后的多余空格、换行符导致转换后出现异常空白字符，影响搜索匹配
• name_normalized字段必须加索引，数据量超过1万条后无索引的模糊查询性能会明显下降
• 不要假设所有姓名都符合「姓,名」格式，必须加异常兜底逻辑，避免单条格式错误中断整个CSV导入任务
• 如果后续单表数据超过百万级，再考虑把普通模糊搜索替换为MySQL全文索引或者专用搜索引擎，当前方案在十万级数据量下性能足够

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