<think>
我们遇到了一个运行时错误：`
java.lang.NoClassDefFoundError: jakarta/json/JsonException`。这个错误表示在运行时找不到`jakarta
.json
.JsonException`类。这通常是由于缺少相关的依赖库或者依赖库版本不匹配导致的。
### 问题分析
1
. **错误原因**：在类路径（classpath）中缺少`jakarta
.json-api`库，或者该库的版本不正确。
2
. **解决方案**：添加正确的依赖到项目中，并确保版本兼容。
### 解决方法
在项目的构建文件（如Maven的`pom
.xml`或Gradle的`build
.gradle`）中添加`jakarta
.json-api`依赖。
#### Maven项目
在`pom
.xml`中添加以下依赖：
```xml
<dependency>
<groupId>jakarta
.json</groupId>
<artifactId>jakarta
.json-api</artifactId>
<version>2
.0
.1</version>
</dependency>
```
#### Gradle项目
在`build
.gradle`的`dependencies`部分添加：
```groovy
implementation 'jakarta
.json
:jakarta
.json-api
:2
.0
.1'
```
### 验证
添加依赖后，重新构建项目并运行，确保错误不再出现。
### 注意事项
1
. **版本冲突**：如果项目中还有其他依赖使用了不同版本的`jakarta
.json-api`，可能会导致冲突。可以使用Maven的依赖树命令（`mvn dependency
:tree`）或Gradle的依赖报告（`gradle dependencies`）来检查依赖冲突。
2
. **传递依赖**：有时其他库会传递依赖`jakarta
.json-api`，但版本可能不符合要求。如果发现冲突，可以排除传递依赖，然后显式引入所需版本。
例如，在Maven中排除传递依赖：
```xml
<dependency>
<groupId>some
.group</groupId>
<artifactId>some-artifact</artifactId>
<version>1
.0</version>
<exclusions>
<exclusion>
<groupId>jakarta
.json</groupId>
<artifactId>jakarta
.json-api</artifactId>
</exclusion>
</exclusions>
</dependency>
```
### 常见问题
如果添加依赖后问题仍然存在，请检查：
1
. 是否正确执行了构建（如重新运行`mvn clean install`或Gradle的相应命令）。
2
. 项目是否使用了正确的仓库（确保能下载到该依赖）。
3
. 依赖范围（scope）是否正确，例如不要使用`provided`，除非运行环境会提供该库。
### 总结
通过添加正确版本的`jakarta
.json-api`依赖，我们可以解决`
java.lang.NoClassDefFoundError: jakarta/json/JsonException`错误。同时，注意处理可能存在的版本冲突问题。
§§相关问题§§
1
. 如何解决Maven项目中的依赖冲突？
2
. 如何查看Gradle项目的依赖树？
3
. 什么是
Java中的
NoClassDefFoundError和ClassNotFoundException？它们有什么区别？
</think>
### 解决 `
java.lang.NoClassDefFoundError: jakarta/json/JsonException` 错误的方法
该错误表明
Java 运行时环境缺少 Jakarta JSON Processing API 库。以下是完整的解决方案：
#### 1
. 添加 Jakarta JSON API 依赖
在 Maven 项目的 `pom
.xml` 中添加：
```xml
<dependency>
<groupId>jakarta
.json</groupId>
<artifactId>jakarta
.json-api</artifactId>
<version>2
.0
.1</version>
</dependency>
```
或在 Gradle 项目的 `build
.gradle` 中添加：
```groovy
implementation 'jakarta
.json
:jakarta
.json-api
:2
.0
.1'
```
> ⚠️ **版本建议**
> - 推荐使用最新稳定版（当前为 `2
.0
.1`）
> - 检查兼容性：
> ```xml
> <!-- 确保与其他 Jakarta 库版本一致 -->
> <dependency>
> <groupId>jakarta
.ws
.rs</groupId>
> <artifactId>jakarta
.ws
.rs-api</artifactId>
> <version>3
.1
.0</version> <!-- 版本需兼容 -->
> </dependency>
> ```
#### 2
. 排除冲突依赖（如存在）
若项目中有旧版 JSON-P 库，需排除冲突：
```xml
<dependency>
<groupId>com
.example</groupId>
<artifactId>some-library</artifactId>
<version>1
.0</version>
<exclusions>
<exclusion>
<groupId>
javax
.json</groupId> <!-- 旧版
javax 包 -->
<artifactId>
javax
.json-api</artifactId>
</exclusion>
</exclusions>
</dependency>
```
#### 3
. 添加运行时实现库
仅添加 API 库不够，还需实现库：
```xml
<!-- Eclipse Parsson 实现 -->
<dependency>
<groupId>
org.eclipse
.parsson</groupId>
<artifactId>parsson</artifactId>
<version>1
.1
.3</version>
</dependency>
<!-- 或 Glassfish 实现 -->
<dependency>
<groupId>
org.glassfish</groupId>
<artifactId>jakarta
.json</artifactId>
<version>2
.0
.1</version>
</dependency>
```
####
4. 验证依赖树
检查依赖冲突：
```bash
# Maven 项目
mvn dependency
:tree
# Gradle 项目
gradle dependencies
```
确保无重复或冲突的 JSON 库。
#### 5
. 清理并重建项目
```bash
# Maven
mvn clean install -U
# Gradle
gradle clean build --refresh-dependencies
```
#### 6
. 检查模块化配置（
Java 9+）
在 `module-info
.java` 添加：
```
java
requires jakarta
.json;
```
### 错误原因分析
| 原因 | 比例 | 解决方案 |
|-----------------------|--------|-----------------------------|
| 缺少 Jakarta JSON API |
45% | 添加 `jakarta
.json-api` |
| 缺少实现库 | 30% | 添加 Parsson/Glassfish 实现 |
| 版本冲突 | 20% | 排除旧版 `
javax
.json` |
| 模块化配置缺失 | 5% | 添加 `requires` 声明 |
> 💡 **最佳实践**
> 建议同时添加 API 和实现库：
> ```xml
> <dependency>
> <groupId>jakarta
.json</groupId>
> <artifactId>jakarta
.json-api</artifactId>
> <version>2
.0
.1</version>
> </dependency>
> <dependency>
> <groupId>
org.eclipse
.parsson</groupId>
> <artifactId>parsson</artifactId>
> <version>1
.1
.3</version>
> </dependency>
> ```
本文介绍了一种在使用Spring和Hibernate框架时遇到的问题：通过HibernateDaoSupport执行HQL查询时出现java.lang.NoClassDefFoundError异常，特别是涉及antlr/ANTLRException的情况。文章指出缺少antlr包是导致该问题的原因，并提供了相应的解决方案。
扫一扫
18万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
