1. 開(kāi)胃菜：一句話認(rèn)識(shí) @TableField

@TableField 是 MyBatis-Plus 提供的字段級(jí)注解，用于非主鍵字段與數(shù)據(jù)庫(kù)列的顯式綁定與行為控制。
記住兩個(gè)關(guān)鍵字：“非主鍵”、“行為控制”——這是它與 @TableId 的核心差異。

2. 為什么需要它？

3. 快速上手：5 個(gè)最常用的屬性

@Data
@TableName("t_user")
public class User {
    @TableId(type = IdType.AUTO)
    private Long id;
    // 1. 列名不一致
    @TableField("user_name")
    private String name;
    // 2. 虛擬字段，不持久化
    @TableField(exist = false)
    private String token;
    // 3. 查詢(xún)時(shí)不返回
    @TableField(select = false)
    private String password;
    // 4. 插入自動(dòng)寫(xiě)入
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    // 5. 更新自動(dòng)寫(xiě)入
    @TableField(fill = FieldFill.UPDATE)
    private LocalDateTime updateTime;
    // 6. 樂(lè)觀鎖
    @Version
    @TableField("version")
    private Integer version;
}

4. 源碼級(jí)剖析：MP 如何把注解變成 SQL

4.1 解析入口

TableInfoHelper#initTableInfo → 反射讀取所有字段 → 構(gòu)建 TableFieldInfo 列表。

4.2 SQL 拼接

AbstractSqlInjector 注入通用 CRUD 方法 →
DefaultSqlProvider 按 TableFieldInfo 生成 SQL 片段 →
select=false 的字段被主動(dòng)剔除，exist=false 的字段直接忽略。

4.3 填充與樂(lè)觀鎖

MetaObjectHandler 接口處理 FieldFill；
MybatisPlusInterceptor 內(nèi)的 OptimisticLockerInnerInterceptor 處理 @Version。

5. 企業(yè)級(jí)高階玩法

5.1 動(dòng)態(tài)過(guò)濾字段 —— 防止數(shù)據(jù)越權(quán)

// 場(chǎng)景：普通用戶(hù)不能查看薪資字段
@TableField(select = false, condition = "%s != 'admin'")
private BigDecimal salary;

配合 TenantLineInterceptor 可實(shí)現(xiàn)動(dòng)態(tài)列級(jí)權(quán)限。

5.2 加密存儲(chǔ) —— 自定義 TypeHandler

@TableField(typeHandler = AesTypeHandler.class)
private String idCard;

插入自動(dòng)加密，查詢(xún)自動(dòng)解密，業(yè)務(wù)代碼零侵入。

5.3 多租戶(hù)隔離 —— 租戶(hù)字段加索引

@TableField("tenant_id")
@InterceptorIgnore(tenantLine = "true") // 跳過(guò)插件，避免死循環(huán)
private Long tenantId;

6. 高頻踩坑 & 排查清單

7. 和 Spring 注解的“夢(mèng)幻聯(lián)動(dòng)”

@Component
public class MyMetaHandler implements MetaObjectHandler {
    @Override
    public void insertFill(MetaObject metaObject) {
        // Spring 容器直接注入
        this.strictInsertFill(metaObject, "createTime", 
                              LocalDateTime.class, LocalDateTime.now());
    }
}

@TableField 負(fù)責(zé)標(biāo)記，Spring 負(fù)責(zé)注入，兩者解耦，符合單一職責(zé)。

8. 總結(jié)：一張腦圖記住 @TableField

@TableField
├─ value          映射列名
├─ exist          是否持久化
├─ select         是否參與查詢(xún)
├─ fill           自動(dòng)填充策略
├─ update         自定義 set 片段
├─ condition      動(dòng)態(tài)條件
├─ typeHandler    類(lèi)型轉(zhuǎn)換
└─ keepGlobalFormat 保留全局格式

9. 一鍵復(fù)制即可跑的最小 Demo

GitHub：https://github.com/YOUR_NAME/mp-tablefield-demo
分支：feature/tablefield-demo
包含：加密、樂(lè)觀鎖、多租戶(hù)、自動(dòng)填充 4 大示例，Maven 一鍵啟動(dòng)。

10. 評(píng)論區(qū) FAQ 預(yù)覽（提前回答）

Q1：@TableField 和 @Column 有什么區(qū)別？
A：后者是 JPA 規(guī)范，只在 Hibernate 生效；前者是 MyBatis-Plus 專(zhuān)用，功能更強(qiáng)。

Q2：能否在 Kotlin data class 使用？
A：可以，但字段必須聲明為 var，否則無(wú)法填充。

Q3：性能會(huì)下降嗎？
A：解析結(jié)果緩存到 TableInfo，運(yùn)行期零反射，性能損耗 < 1%。

到此這篇關(guān)于一文講透一個(gè) SpringBoot 裝飾器 —— @TableField的文章就介紹到這了,更多相關(guān)SpringBoot 裝飾器@TableField內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論