如何在TypeORM中处理Blob列？实现Base64头像REST接口

嗨，这个需求我之前做过类似的，刚好可以给你详细说说~ 你已经把Blob列映射成Buffer类型是完全正确的，TypeORM处理MySQL的Blob字段时，Buffer是最适配的类型。至于是否要用属性监听器，其实更推荐用实体的getter方法或者查询后的转换逻辑，比属性监听器更贴合这个场景，下面给你具体的实现步骤：

在你的User实体中，新增一个getter属性，专门用来把Buffer类型的avatar转换成Base64字符串。如果配合class-transformer库的话，还能确保这个属性在实体转JSON时被自动包含进去（因为默认TypeORM实体的getter不会被序列化到JSON中）。

示例代码：

import { Entity, Column, PrimaryGeneratedColumn } from 'typeorm';
import { Expose } from 'class-transformer';

@Entity('users')
export class User {
  @PrimaryGeneratedColumn()
  id: number;

  @Column({ length: 50 })
  username: string;

  // 映射MySQL的Blob字段为Buffer类型
  @Column({ type: 'blob', nullable: true })
  avatar: Buffer;

  // 自定义Getter：将Buffer转为Base64字符串
  @Expose() // 标记这个属性需要被序列化
  get avatarBase64(): string | null {
    // 处理头像为空的情况
    return this.avatar ? this.avatar.toString('base64') : null;
  }
}

在你的API接口中，查询到User实体后，用class-transformer的classToPlain方法把实体转换成可序列化的对象，这样avatarBase64就会被包含在返回的JSON里了。

以Express为例的示例代码：

import express from 'express';
import { getRepository } from 'typeorm';
import { User } from './entities/user.entity';
import { classToPlain } from 'class-transformer';

const app = express();
app.use(express.json());

// 获取单个用户信息的接口
app.get('/api/users/:id', async (req, res) => {
  const userRepository = getRepository(User);
  const user = await userRepository.findOne(req.params.id);

  if (!user) {
    return res.status(404).json({ message: '用户不存在' });
  }

  // 将实体转换为包含avatarBase64的普通对象
  const responseData = classToPlain(user);
  res.status(200).json(responseData);
});

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

属性监听器（比如setter）主要是在设置实体属性值的时候触发，但我们的场景是从数据库读取已有的Buffer数据，然后转换为Base64返回给前端——这是一个“读取后转换”的操作，而非“设置时转换”。用getter的方式更符合这个逻辑，而且代码更清晰、可维护性更高。

如果你不想在实体层处理，也可以用TypeORM的QueryBuilder，直接调用MySQL的TO_BASE64函数在查询时把Blob转成Base64字符串：

const user = await userRepository.createQueryBuilder('user')
  .select([
    'user.id',
    'user.username',
    'TO_BASE64(user.avatar) AS avatarBase64'
  ])
  .where('user.id = :id', { id: req.params.id })
  .getRawOne();

res.json(user);

不过这种方式返回的是原始数据库结果对象，不是User实体实例，适合不需要操作实体的简单场景。

总的来说，最推荐的是实体Getter + class-transformer的组合，既保持了实体的完整性，又能自动完成Base64转换，非常适合REST API的返回需求。

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