NetBeans中JPA实体新增列未同步数据库，如何配置javax.persistence？

问题背景 #

在NetBeans开发的三层Java企业应用中，基于表模型、数据交互门面、JavaBeans控制器和XHTML显示页面的架构，现有通过JPA实体类生成的Booking表，包含ID（主键）、status、date字段。现在需要新增FOOD、SEATS、RATING列，但访问调用该表的网页时出现报错：

Internal Exception: java.sql.SQLSyntaxErrorException: Column 'FOOD' is either not in any table in the FROM list or appears within a join specification and is outside the scope of the join specification or appears in a HAVING clause and is not in the GROUP BY list. If this is a CREATE or ALTER TABLE statement then 'FOOD' is not a column in the target table. Error Code: 30000

已在Booking实体类中添加对应字段并标注@Column注解（代码如下），但persistence.xml配置了javax.persistence.schema-generation.database.action=create后，新列仍未生成，且需要在不删除现有表的前提下解决问题。

已修改的Booking实体类代码 #

public class Booking implements Serializable {

    private static final long serialVersionUID = 1L;
    
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "ID")
    private Long id;
    
    @Temporal(TemporalType.DATE)
    private Date bookingDate;
    
    private String status;
    @Column(name = "FOOD")
    private String food;
    @Column(name = "SEATS")
    private Long seats;
    @Column(name = "RATING")
    private Long rating;
    @Column(name = "REVIEW")
    private String review;
    
    private Long assignedKitchenStaffId;
    private Long customerId;

    @JoinColumn(name = "ASSIGNEDKITCHENSTAFF_ID")
    @ManyToOne
    private User assignedKitchenStaff;
    
    @JoinColumn(name = "CUSTOMER_ID")
    @ManyToOne
    private User customer;
}

问题原因 #

• 当前persistence.xml中的create模式仅会在数据库不存在对应表时创建新表，不会对已存在的表执行ALTER操作来新增列。
• 实体类的字段变更没有同步到数据库的表结构中，导致SQL查询时找不到新增的列。

解决方案 #

方法1：修改JPA schema生成策略（快速验证） #

将persistence.xml中的schema生成属性改为update，让JPA自动更新表结构：

<property name="javax.persistence.schema-generation.database.action" value="update"/>

注意：该策略依赖具体JPA实现（如Hibernate、EclipseLink）的自动更新能力，部分复杂场景可能存在兼容问题，生产环境建议谨慎使用。

方法2：手动执行SQL语句（生产环境推荐） #

直接在数据库客户端执行ALTER TABLE语句新增列，以MySQL为例：

ALTER TABLE Booking 
ADD COLUMN FOOD VARCHAR(255),
ADD COLUMN SEATS BIGINT,
ADD COLUMN RATING BIGINT,
ADD COLUMN REVIEW VARCHAR(255);

执行完成后重启应用即可，这种方式可控性强，能避免自动更新带来的意外风险。

方法3：针对EclipseLink的专属配置（NetBeans默认JPA实现） #

如果使用的是EclipseLink，可添加以下配置让框架自动扩展表结构：

<property name="eclipselink.ddl-generation" value="create-or-extend-tables"/>
<property name="eclipselink.ddl-generation.output-mode" value="database"/>

该配置会在表已存在的情况下，自动新增缺失的列，无需删除原有表。

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