MySQL 新增字段但 Java 实体未更新：潜在问题与解决方案

如果新增字段是 NOT NULL 且无默认值：

ALTER TABLE statistics_data ADD COLUMN new_column INT NOT NULL;

如果新增字段允许 NULL 或有默认值：

ALTER TABLE statistics_data ADD COLUMN new_column INT DEFAULT 0;

2.3 批量插入（saveBatch）

saveBatch() 的底层逻辑：

// MyBatis-Plus 默认实现（简化版）
public boolean saveBatch(Collection<T> entityList) {
    for (T entity : entityList) {
        baseMapper.insert(entity); // 生成 INSERT SQL，仅包含实体类定义的字段
    }
    return true;
}

• 如果 new_column 是 NOT NULL，由于 SQL 不包含该字段，MySQL 会报错。
• 如果允许 NULL 或设置默认值，则正常执行。

3. 解决方案

3.1 临时修复（不推荐长期使用）

（1）修改数据库字段约束

-- 允许 NULL
ALTER TABLE statistics_data MODIFY new_column INT NULL;
-- 或设置默认值
ALTER TABLE statistics_data MODIFY new_column INT DEFAULT 0;

（2）避免自动映射，手动指定 SQL

// 使用 @TableField(exist = false) 忽略未知字段
@TableField(exist = false)
private String ignoredField;
// 或自定义 SQL（明确指定插入字段）
@Insert("INSERT INTO statistics_data (agent_id, click) VALUES (#{agentId}, #{click})")
void customInsert(StatisticsData data);

3.2 长期最佳实践（推荐）

（1）同步更新 Java 实体类

@Data
@TableName("statistics_data")
public class StatisticsData extends BaseModel {
    private String agentId;
    private Long click;
    private Integer newColumn; // 新增字段
}

（2）使用数据库迁移工具（如 Flyway/Liquibase）

-- V1__init.sql
CREATE TABLE statistics_data (...);
-- V2__add_new_column.sql
ALTER TABLE statistics_data ADD COLUMN new_column INT DEFAULT 0;

（3）自动化检查（可选）

通过单元测试或 Schema 校验工具，确保数据库与实体类一致：

// 示例：使用 Hibernate Validator 检查（如果适用）
@Column(nullable = false)
private Integer newColumn;

4. 完整代码示例

4.1 更新后的 Java 实体

@Data
@TableName("statistics_data")
public class StatisticsData extends BaseModel {
    private String agentId;
    private Long click;
    private Integer newColumn; // 新增字段
    @TableField("`date`")
    private String date; // 其他字段...
}

4.2 安全的批量插入方法

// 检查数据完整性后再插入
public void safeBatchInsert(List<StatisticsData> dataList) {
    if (dataList == null || dataList.isEmpty()) {
        return;
    }
    // 可在此处做字段校验
    statisticsDataService.saveBatch(dataList);
}

4.3 数据库变更脚本（Flyway 示例）

-- V2__add_new_column.sql
ALTER TABLE statistics_data ADD COLUMN new_column INT NOT NULL DEFAULT 0 COMMENT '新增字段';

5. 总结

最佳实践：

1. 保持数据库和 Java 实体同步，避免未知问题。
2. 使用数据库迁移工具（如 Flyway）管理表结构变更。
3. 重要字段设置合理约束（如 NOT NULL + DEFAULT）。

6. 扩展思考

• 如果使用 JPA/Hibernate，启动时会自动校验表结构，不一致直接报错。
• MyBatis-Plus 的 @TableField(exist = false) 可标记非数据库字段。
• 自动化生成实体类工具（如 MyBatis-Plus Generator）可减少手动同步成本。

通过合理的架构设计，可以避免这类'数据库与代码不同步'的问题，提高系统稳定性。