NetBeans生成的REST服务支持XML请求但JSON请求报错

我之前在NetBeans里生成REST服务时也碰到过一模一样的JSON报错问题，结合你的操作流程和错误日志，这问题根源很明确，下面给你拆解分析和解决办法：

问题背景 #

我正在用NetBeans构建REST Web服务，操作步骤如下：

• 新建项目 -> Web应用程序
• 新建文件 -> Web服务 -> 从数据库生成RESTful Web服务
• 选择MySQL数据源
• 生成完成后，右键项目 -> 测试RESTful Web服务

测试GET(application/XML)时正常返回结果，自己写的Jersey Client也能获取XML响应，但测试JSON功能时始终报错：

exception javax.servlet.ServletException: org.glassfish.jersey.server.ContainerException: java.lang.NoClassDefFoundError: Could not initialize class org.eclipse.persistence.jaxb.BeanValidationHelper
root cause org.glassfish.jersey.server.ContainerException: java.lang.NoClassDefFoundError: Could not initialize class org.eclipse.persistence.jaxb.BeanValidationHelper
root cause java.lang.NoClassDefFoundError: Could not initialize class org.eclipse.persistence.jaxb.BeanValidationHelper

我的数据库Schema如下：

-- ****************** SqlDBM: MySQL ******************;
-- ***************************************************;
DROP TABLE `roles`;
DROP TABLE `orders`;
DROP TABLE `inventory`;
DROP TABLE `users`;
DROP TABLE `warehouses`;
DROP TABLE `inventory`;
DROP TABLE `addresses`;
DROP TABLE `products`;

-- ************************************** `addresses`
CREATE TABLE `addresses` (
 `addressID` INTEGER NOT NULL AUTO_INCREMENT ,
 `streetNum` INTEGER NOT NULL ,
 `streetName` VARCHAR(45) NOT NULL ,
 `unitNum` INTEGER ,
 `city` VARCHAR(45) NOT NULL ,
 `province` VARCHAR(45) NOT NULL ,
 `postalCode` VARCHAR(6) NOT NULL ,
 PRIMARY KEY (`addressID`)
);

-- ************************************** `products`
CREATE TABLE `products` (
 `productID` INTEGER NOT NULL AUTO_INCREMENT ,
 `productNO` VARCHAR(40) NOT NULL ,
 `productName` VARCHAR(80) NOT NULL ,
 `productDesc` VARCHAR(160) NOT NULL ,
 `cost` REAL NOT NULL ,
 `price` REAL NOT NULL ,
 PRIMARY KEY (`productID`)
);

-- ************************************** `users`
CREATE TABLE `users` (
 `userID` INTEGER NOT NULL AUTO_INCREMENT ,
 `firstName` VARCHAR(20) NOT NULL ,
 `lastName` VARCHAR(20) NOT NULL ,
 `dateOfBirth` DATE NOT NULL ,
 `email` VARCHAR(45) NOT NULL ,
 `password` CHAR(64) NOT NULL ,
 `addressID` INTEGER NOT NULL ,
 PRIMARY KEY (`userID`),
 KEY `fkIdx_87` (`addressID`),
 CONSTRAINT `FK_87` FOREIGN KEY `fkIdx_87` (`addressID`) REFERENCES `addresses` (`addressID`)
);

-- ************************************** `warehouses`
CREATE TABLE `warehouses` (
 `warehouseID` INTEGER NOT NULL AUTO_INCREMENT ,
 `addressID` INTEGER NOT NULL ,
 PRIMARY KEY (`warehouseID`),
 KEY `fkIdx_58` (`addressID`),
 CONSTRAINT `FK_58` FOREIGN KEY `fkIdx_58` (`addressID`) REFERENCES `addresses` (`addressID`)
);

-- ************************************** `inventory`
CREATE TABLE `inventory` (
 `id` INTEGER NOT NULL AUTO_INCREMENT ,
 `productID` INTEGER NOT NULL ,
 `warehouseID` INTEGER NOT NULL ,
 `expiry` DATE NOT NULL ,
 `productID_1` INTEGER NOT NULL ,
 PRIMARY KEY (`id`),
 KEY `fkIdx_31` (`productID_1`),
 CONSTRAINT `FK_31` FOREIGN KEY `fkIdx_31` (`productID_1`) REFERENCES `products` (`productID`)
);

-- ************************************** `roles`
CREATE TABLE `roles` (
 `roleID` INTEGER NOT NULL AUTO_INCREMENT ,
 `roleName` VARCHAR(20) NOT NULL ,
 `userID` INTEGER NOT NULL ,
 PRIMARY KEY (`roleID`),
 KEY `fkIdx_96` (`userID`),
 CONSTRAINT `FK_96` FOREIGN KEY `fkIdx_96` (`userID`) REFERENCES `users` (`userID`)
);

-- ************************************** `orders`
CREATE TABLE `orders` (
 `orderID` INTEGER NOT NULL AUTO_INCREMENT ,
 `orderNum` INTEGER NOT NULL ,
 `productID` INTEGER NOT NULL ,
 `quantity` INTEGER NOT NULL ,
 `userID` INTEGER NOT NULL ,
 PRIMARY KEY (`orderID`),
 KEY `fkIdx_70` (`productID`),
 CONSTRAINT `FK_70` FOREIGN KEY `fkIdx_70` (`productID`) REFERENCES `products` (`productID`),
 KEY `fkIdx_100` (`userID`),
 CONSTRAINT `FK_100` FOREIGN KEY `fkIdx_100` (`userID`) REFERENCES `users` (`userID`)
);

-- ************************************** `inventory`
CREATE TABLE `inventory` (
 `id` INTEGER NOT NULL AUTO_INCREMENT ,
 `expiry` DATE ,
 `productID` INTEGER NOT NULL ,
 `warehouseID` INTEGER NOT NULL ,
 PRIMARY KEY (`id`),
 KEY `fkIdx_40` (`productID`),
 CONSTRAINT `FK_40` FOREIGN KEY `fkIdx_40` (`productID`) REFERENCES `products` (`productID`),
 KEY `fkIdx_62` (`warehouseID`),
 CONSTRAINT `FK_62` FOREIGN KEY `fkIdx_62` (`warehouseID`) REFERENCES `warehouses` (`warehouseID`)
);

问题分析与解决办法 #

核心原因 #

这个报错是因为NetBeans默认用EclipseLink MOXy作为JAXB实现来处理JSON序列化，但BeanValidation相关的依赖包没有被自动添加到项目中，导致运行时找不到org.eclipse.persistence.jaxb.BeanValidationHelper类。XML能正常工作是因为XML序列化不需要BeanValidation的额外依赖，而JSON处理触发了MOXy的BeanValidation逻辑。

解决步骤 #

方法1：通过NetBeans添加缺失的依赖

1. 右键你的Web项目 -> Properties -> Libraries
2. 点击Add Library，在弹出的列表中找到EclipseLink JAXB (MOXy) 并添加
3. 如果还是不行，再添加Java EE Web API或者Validation API库
4. 清理并重新构建项目，然后重启服务器测试JSON接口

方法2：手动添加Maven依赖（如果用Maven管理）

如果你的项目是Maven管理的，在pom.xml中添加以下依赖（版本和NetBeans内置的EclipseLink保持一致即可）：

<dependency>
    <groupId>org.eclipse.persistence</groupId>
    <artifactId>org.eclipse.persistence.moxy</artifactId>
    <version>2.7.10</version>
</dependency>
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>

方法3：禁用BeanValidation（临时方案）

如果不需要BeanValidation功能，可以在persistence.xml中添加配置禁用它：

<property name="eclipselink.jaxb.bean.validation.mode" value="NONE"/>

额外注意点 #

你的数据库Schema中有重复的inventory表定义，这会导致数据库初始化失败，建议删除其中一个重复的表创建语句，避免后续出现其他问题。

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