java.lang.NoClassDefFoundError: io/grpc/Deadline

### 解决 Java `NoClassDefFoundError` 错误

当遇到 `java.lang.NoClassDefFoundError: io/grpc/Deadline` 这样的错误时，表明 JVM 在运行期无法找到指定的类。此问题通常由以下几个原因引起[^1]：

- **缺少依赖库**：最常见的情况是没有将必要的 JAR 文件加入到项目的 classpath 中。
- **版本冲突**：不同版本之间的不兼容可能导致某些类不可用。
- **打包问题**：如果项目被打包成可执行 jar 或 war 文件，则可能存在构建过程中遗漏了所需的外部库。

针对上述情况，可以采取如下措施来解决问题：

#### 添加缺失的 gRPC 库
确保已经包含了最新的 gRPC 客户端库及其所有传递性依赖项。可以通过 Maven 或 Gradle 自动管理这些依赖关系。对于 Maven 用户来说，在 pom.xml 文件中添加以下配置即可引入所需组件：

<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-netty-shaded</artifactId>
    <version>1.48.0</version>
</dependency>
<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-protobuf</artifactId>
    <version>1.48.0</version>
</dependency>
<dependency>
    <groupId>io.grpc</groupId>
    <artifactId>grpc-stub</artifactId>
    <version>1.48.0</version>
</dependency>

#### 设置 ClassPath 参数
如果是通过命令行启动应用程序的话，请务必确认设置了正确的 CLASSPATH 变量，并且其中包含有所有必需的 .jar 文件路径。例如：

java -cp ".;lib/*" com.example.MainApp

这里假设所有的第三方库都存放在名为 “lib”的目录下；而当前工作目录内则放置着编译后的字节码文件(.class)。

#### 使用 Eclipse IDE 编译并导出 Runnable Jar File
考虑到最初是在Eclipse环境中开发的应用程序，建议利用该IDE自带的功能创建一个独立运行的JAR包。这样不仅可以简化部署流程，还能有效避免因环境差异引发的各种异常状况。操作方法为右键点击工程名 -> Export... -> Java -> Runnable JAR file, 接下来按照向导指示完成设置过程即可。