这个文章专门记录在javaEE中遇到的问题和解决方法的😏😏


# 问题 Cannot find class: com.mysql.jdbc.Driver #??mysql??
在第一次学习JavaEE的时候测试项目遇见了以下报错
`Error setting driver on UnpooledDataSource. Cause: java.lang.ClassNotFoundException: Cannot find class: com.mysql.jdbc.Driver #??mysql??`

上网查询后发现是我mybatis-config.xml里面的数据库配置文件写错了，仔细检查是否有拼写错误，检查完发现是我mysql.url写错了，重新拼写后运行成功

![image.png](/static/img/4278a521439f6f5b9b2c02e203e733da.image.webp)

如果上一个解决方法，不能解决你的问题可能就是pom.xml中没有导入相关的mysql依赖，导入依赖即可


```xml
 <dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>8.0.28</version>
 </dependency>
```
# 问题 Mapped Statements collection does not contain value for xxxx
在学习动态SQL的时候遇见了以下报错
` Mapped Statements collection does not contain value for mapper.CustomerMapper.findCustomerByNameAndJobs`
报错原因是因为找不到findCustomerByNameAndJobs这个方法导致的，上网查询后发现，可能是以下几个原因造成的：
1. 对应的映射文件xml里面的 **namespace** 命名空间指向的地址错误了。解决方法:正确的指向pojo所在的路径。
2. mybatis-config.xml 没有导入或者没有正确的导入对应的映射文件。解决方法:在\<mappers>元素中添加\<mapper resource="文件所在地址"/>
3. 对应的映射文件中的 操作语句中的id 方法名没有，或者拼写错误，导致找不到方法。解决方法: 填写调用的方法名(id名)，检查是否拼写正确。
# 问题 java: 无法访问org.springframework.boot.SpringApplication
在学习spring-boot的时候运行项目遇到了以下问题：

`java: 无法访问org.springframework.boot.SpringApplication
 错误的类文件: /C:/Users/44553/.m2/repository/org/springframework/boot/spring-boot/3.2.3/spring-boot-3.2.3.jar!/org/springframework/boot/SpringApplication.class
 类文件具有错误的版本 61.0, 应为 52.0
 请删除该文件或确保该文件位于正确的类路径子目录中`
 检查后发现是因为我创建项目的时候，pom.xml里面的jdk版本和项目所使用的版本不同，导致出现以上报错,解决方法，有以下两个:
 1.更改项目所使用的JDK版本和pom.xml中的jdk版本一致
 操作步骤如下:
 点击 “file选项卡” ----->>选择 “Project Structure ”

![image.png](/static/img/313a5b64537d0c2917c9f5ba1610e05a.image.webp)

更改这两个地方的jdk版本

![image.png](/static/img/3366005cdba897477f3c0b12c2029f42.image.webp)

接着修改modules 里面的 language levet版本,这三个地方的加上pom.xml中jdk的版本修改一致即可

![image.png](/static/img/2760682250badb1a0211f4aaf87304a9.image.webp)

2.修改pom.xml中的jdk版本与项目使用的jdk版本一致即可

![image.png](/static/img/bb93edc8a024e8ac8432881e960c76ea.image.webp)

# 问题 类文件具有错误的版本 61.0, 应为 55.0
在学习SpringBoot的时候创建并运行时出现了以下报错:

```java
java: 无法访问org.springframework.boot.SpringApplication
 错误的类文件: /C:/Users/44553/.m2/repository/org/springframework/boot/spring-boot/3.2.3/spring-boot-3.2.3.jar!/org/springframework/boot/SpringApplication.class
 类文件具有错误的版本 61.0, 应为 55.0
 请删除该文件或确保该文件位于正确的类路径子目录中。
```
检查发现是因为SpringBoot项目的版本和当前使用的jdk版本不一致，根据以下图可发现，项目所需版本是17，而我使用的是11，才导致报错。

![image.png](/static/img/32130b91d01376160a244e15eabf9e87.image.webp)

**解决方法：**
更换项目使用jdk版本，或者降低SpringBoot框架版本即可

# 问题：org.projectlombok:lombok:jar:unknown /1.18.6 not found
在使用lombok时引入lombok依赖开始报红

```java
org.projectlombok:lombok:jar:unknown was not found in https://maven.aliyun.com/repository/public during a previous attempt. This failure was cached in the local repository and resolution is not reattempted until the update interval of alimaven has elapsed or updates are forced
```
报错原因：我自己也不知道


解决方法:
插件库里面下载 lombok插件

![image.png](/static/img/0ba4a548101a97b54fdcebec3c4b61b5.image.webp)

并在pom.xml里面添加以下内容

```xml
 <dependency>
 <groupId>org.projectlombok</groupId>
 <artifactId>lombok</artifactId>
 <version>1.16.18</version>
 <scope>provided</scope>
 </dependency>
```
至此问题就顺利解决

# 问题Cannot find class: com.mysql.cj.jdbc.Driver
出现该问题通常是因为程序在运行时找不到MySQL JDBC驱动程序的jar包

```java
Cause: java.sql.SQLException: Error setting driver on UnpooledDataSource. Cause: java.lang.ClassNotFoundException: Cannot find class: com.mysql.cj.jdbc.Driver
```
解决方法：只需在pom.xml文件中添加对应的依赖即可

```xml
 <dependency>
 <groupId>mysql</groupId>
 <artifactId>mysql-connector-java</artifactId>
 <version>8.0.28</version> 
 </dependency>
```

# 问题 Cause: java.lang.IndexOutOfBoundsException: Index: 30, Size: 30
在帮班级同学解决项目问题时，发现他使用了resultMap时对应的Bean对象里面没有无参构造函数所以造成了以下错误

```java
Cause: java.lang.IndexOutOfBoundsException: Index: 30, Size: 30
```
解决方法：在bean类中添加无参构造函数即可

# 问题com.sun.tools.javac.code.TypeTags
原因：当前使用的lombok版本太低，造成的
解决方法：升级lombok版本

JavaEEBug记录

这个是专门记录大数据学习工作中遇见的问题的👀👀


# Bug日记

## hive 搭建bug

### **问题1：**(2024年3月11日周一)

**在搭建分布式hive时，启动hive客户端查询数据库时发现出现了一下错误：**

```
hive> show databases;
FAILED: SemanticException org.apache.hadoop.hive.ql.metadata.HiveException: java.lang.RuntimeException: Unable to instantiate org.apache.hadoop.hive.ql.metadata.SessionHiveMetaStoreClienthive> show databases;
FAILED: SemanticException org.apache.hadoop.hive.ql.metadata.HiveException: java.lang.RuntimeException: Unable to instantiate org.apache.hadoop.hive.ql.metadata.SessionHiveMetaStoreClient
```

原因是在修改配置文件hive-site.xml时使用的是远程模式，服务器的地址写错了，原本是写hive server地址，thrift://slave01:9083，被我写成了本机的客户端的地址 thrift://slave02:9083

```xml
 <property>
 <name>hive.metastore.uris</name>
 <value>thrift://slave01:9083</value>
 <value/>
 <description>Thrift URI for the remote metastore. Used by metastore client to connect to remote metastore.</description>
 </property>
```

修改成功后启动客户端，发现可以查询出数据了，可是后面又出现了一行记录

```
hive> show databases;
OK
Failed with exception java.io.IOException:java.lang.IllegalArgumentException: java.net.URISyntaxException: Relative path in absolute URI: ${system:user.name%7D
Time taken: 2.115 seconds
```

上网查询解决方案

```xml
 <property>
 <name>hive.exec.local.scratchdir</name>
 <value>/opt/hive/tmp/${system.user.name}</value>
 <description>Local scratch space for Hive jobs</description>
 </property>
 将以上配置修改成以下配置
 <property>
 <name>hive.exec.local.scratchdir</name>
 <value>/opt/hive/tmp/${user.name}</value>
 <description>Local scratch space for Hive jobs</description>
 </property>


```

这样就完美解决问题



### **问题2：**

启动hive --service matestore 时 显示错误 “Address already in use”

产生该问题的原因时，hive启动时的端口被占用，去要我们手动去关闭占用的进程

第一步：查看端口是被哪个进程占用的 

命令：netstat -apn | grep 端口号

第二步:杀掉进程

命令: kill -9 pid

重新启动hive --service matestore 就能ok了



### **问题3：**

启动hive --service matestore时显示以下报错

```
org.datanucleus.store.rdbms.connectionpool.DatastoreDriverNotFoundException: The specified datastore driver ("com.mysql.cj.jdbc.Driver") was not found in the CLASSPATH. Please check your CLASSPATH specification, and the name of the driver.
```

产生该问题的原因是因为hive lib库没有对应的mysql-connector-java-xxx-bin.jar 包

解决方法：可从网上或者maevn本地仓库拷贝一份到hive 的lib库即可



### 问题4：

启动hive --service matestore时显示以下报错

```
java.net.NoRouteToHostException: No Route to Host
```

原因是因为没有找到主机地址，这可能是因为防火墙没有关闭的原因，解决步骤

```
systemctl status firewalld #查看防火墙状态
systemctl stop firewalld #关闭防火墙
systemctl disable firewalld #开机不自启动
```

这样就可以解决该问题。



## 基础bug

### xshell7连接虚拟机超时

解决方法1：检查虚拟机网卡 IPADDR 、NETMASK、GATEWAY、DNS、ONBOOT等配置是否正确，如果错误请进行修改，修改后就可以连接xshell7

解决方法2：windows 点击 “网络和Internet设置” -------> "高级网络设置" -------> “VMnet8” -------> “编辑” -------> “Internet协议版本4” -------> "使用下面的IP地址"，IP填写为虚拟机的网关地址，并填写对应的子网掩码。此时打开xshell7连接即可

解决方法3：vm主页点击“编辑” -------> “虚拟网络编辑器” -------> ”更改设置“ -------> ”还原默认设置“ 还原完成后记得把网段改为原来的即可。

大数据Bug记录

# 如何在飞书插件中配置 OpenClaw 关联多个飞书机器人，对应不同 Agent

插件版本 3.10 以上 且 为飞书官方插件

官方插件地址：OpenClaw飞书官方插件使用指南（公开版）




## 概述

OpenClaw 支持在同一台机器上配置多个飞书机器人账户，实现：
- 账户隔离：每个飞书机器人独立管理，互不干扰
- 路由分发：不同飞书机器人的消息路由到不同的 agent（工作空间）
- 灵活控制：每个账户可以有不同的访问策略、技能权限等

---

## 配置方式

直接编辑配置文件
配置文件路径：~/.openclaw/openclaw.json



## 前提

创建新的飞书机器人，用于关联到新的账号上
一键创建一个OpenClaw 机器人

## 完整示例

飞书多机器人账号 + 多 Agent 路由

```json
{
 // 定义多个 agent（隔离的工作空间和记忆）
 "agents": {
 "list": [
 {
 "id": "main",
 "name": "主助手",
 "default": true,
 "workspace": "~/.openclaw/workspace-main",
 "model":{
 "primary": "ollama/qwen3.5:35b" // 配置模型
 }
 },
 {
 "id": "test1",
 "name": "工作助手",
 "workspace": "~/.openclaw/workspace-test1",
 "model":{
 "primary": "ollama/deepseek"
 }
 },
 {
 "id": "test2",
 "name": "客服助手",
 "workspace": "~/.openclaw/workspace-test2",
 "model":{
 "primary": "ollama/qwen3.5:35b"
 }
 }
 ]
 },
 
 // 配置会话隔离
 "session": {
 "dmScope": "per-account-channel-peer"
 },
 
 
 // 配置飞书多账户
 "channels": {
 "feishu": {
 "enabled": true,
 "threadSession": true, // 原生openclaw 4.12版本中不存在这个属性
 "replyMode": "auto",
 // 默认机器人配置，必须要有！！
 "appId": "cli_xxx", // 可为空
 "appSecret": "xxx", // 可为空
 
 "accounts": {
 "default": {},
 
 // 工作机器人1
 // agents.list[1].id 保持一致
 "test1": {
 "appId": "cli_work_yyy",
 "appSecret": "work_secret_yyy",
 "botName": "工作机器人", //openclaw 4.12版本中不存在这个属性 可用name
 "dmPolicy": "allowlist",
 "allowFrom": ["ou_5b990e213988b9bcf396f955a50b2a22", "ou_1234567890abcdef"], //类似于白名单
 },
 
 // 机器人2
 // agents.list[2].id 保持一致
 "test2": {
 "appId": "cli_support_zzz",
 "appSecret": "support_secret_zzz",
 "botName": "客服机器人",
 "dmPolicy": "open",
 "allowFrom": ["*"] // 所有人可使用
 }
 },
 
 // 群组配置
 "groups": {
 "*": { "requireMention": true },
 "oc_83e1c0d069b94efc09ad22e05bc06365": {
 "requireMention": false,
 "groupPolicy": "open"
 },
 "oc_dev_123456789": {
 "requireMention": false,
 "groupPolicy": "allowlist",
 "allowFrom": ["ou_dev_001", "ou_dev_002"],
 }
 },
 
 "groupPolicy": "allowlist",
 "groupAllowFrom": [
 "ou_user1",
 "ou_user2",
 "oc_chat1"
 ]
 }
 },
 
 // 路由绑定
 "bindings": [
 { "agentId": "main", "match": { "channel": "feishu", "accountId": "default" } },
 { "agentId": "work", "match": { "channel": "feishu", "accountId": "work" } },
 { "agentId": "support", "match": { "channel": "feishu", "accountId": "support" } },
 {
 "agentId": "test1", // 绑定agent
 "match": {
 "channel": "feishu", // 消息通道使用飞书
 "peer": { "kind": "direct", "id": "ou_owner_user" }
 }
 },
 {
 "agentId": "test2",
 "match": {
 "channel": "feishu",
 "peer": { "kind": "group", "id": "oc_support_group_123" }
 }
 }
 ]
}

```
---

## 路由规则优先级

当收到飞书消息时，OpenClaw 按以下顺序匹配路由：
1. 精确匹配：peer.kind + peer.id（特定用户/群组）
2. 父级匹配：线程继承
3. 账户匹配：accountId
4. 渠道匹配：channel + accountId: "*"
5. 默认 Agent：agents.list[].default 或第一个 agent

---

## 常用命令

|命令 | 说明 |
| --- | --- |
|openclaw channels list | 查看所有渠道账户状态|
|openclaw channels status | 查看渠道状态|
|openclaw agents bindings | 查看路由绑定|
|openclaw gateway status | 查看 Gateway 状态|
|openclaw logs --follow | 查看日志|

---

## ID 格式参考

|类型 | 格式 | 示例|
| --- | --- | --- |
|App ID | cli_xxx | cli_a1b2c3d4e5f6g7h8|
|用户 Open ID | ou_xxx | ou_5b990e213988b9bcf396f955a50b2a22|
|群组 Chat ID | oc_xxx | oc_83e1c0d069b94efc09ad22e05bc06365|

### 获取 ID 的方法
**群组 ID（chat_id）**：
1. 启动 Gateway，在群里 @机器人
2. 运行 openclaw logs --follow 查看 chat_id

**用户 ID（open_id）**：
1. 启动 Gateway，私聊机器人
2. 运行 openclaw logs --follow 查看 open_id

---

## dmPolicy 参考

|值 | 行为
| --- | --- |
|"pairing" | 默认。未知用户收到配对码，需要管理员批准
|"allowlist" | 只有 allowFrom 中的用户可以聊天
|"open" | 允许所有用户（需要在 allowFrom 中添加 "*"）
"disabled" | 禁用私聊

---

## 多账号会话隔离（dmScope）

值 | 隔离粒度 | 行为
| --- | --- | --- |
main | 最粗粒度 | 所有私聊共用一个会话
per-peer | 按用户粒度 | 同一用户跨不同 channel 共享会话
per-channel-peer | 按 channel + 用户 粒度 | 不同 channel 的同一用户各自独立，但同 channel 下多账号仍共享
per-account-channel-peer | 按账号 + channel + 用户 粒度 | 多账号推荐，每个机器人与每个用户的会话完全独立

按账号 + channel + 用户 粒度设置隔离的快捷指令：

```bash
openclaw config set session.dmScope "per-account-channel-peer"
```


:::warning{title="注意"}
仅设置 session.dmScope 不够——还需通过 agents + bindings 将不同账号绑定到不同 agent，才能实现记忆完全隔离
:::
---

## 故障排查

### 检查配置问题

```bash
openclaw doctor
```
### 自动修复配置问题

```bash
openclaw doctor --fix
```
### 查看详细状态

```bash
openclaw status --deep
```

### 查看日志

```bash
openclaw logs --follow
```

Openclaw中配置飞书多账户agent独立消息

# Docker 更换国内源教程
Docker 默认使用国外官方源，下载镜像时速度较慢，甚至出现超时失败。本教程适配 Windows、macOS、Linux 三大系统，教你更换国内优质镜像源，解决下载慢问题，同时附上源的优先级、测试方法及常见问题排查。

## 一、前置准备
- 已安装 Docker Desktop（Windows/macOS）或 Docker Engine（Linux），且能正常启动。
- 确认网络通畅，能访问国内镜像源服务器（如阿里云、网易、科大等）。
- Linux 系统需具备 root 权限（或 sudo 权限），Windows/macOS 需以管理员身份操作 Docker。



## 二、常用国内优质 Docker 源
优先选择稳定、更新及时的源，以下是主流国内源（任选其一或组合使用）：
- 阿里云 Docker 镜像源（推荐）：https://docker.mirrors.aliyun.com
- 网易云 Docker 镜像源：https://hub-mirror.c.163.com
- 科大镜像源：https://docker.mirrors.ustc.edu.cn
- 腾讯云 Docker 镜像源：https://mirror.ccs.tencentyun.com
- 华为云 Docker 镜像源：https://mirrors.huaweicloud.com/docker/

注意：部分源可能存在临时维护，若更换后无法使用，可切换至其他源。

:::tip{title="提示"}
提示 本网站已搭建自动生成配置文件的程序自动获取最新国内可用源可前往[ docker配置文件](https://blog.suhm.top/c/dockerconfig)进行配置。
:::

## 三、分系统更换教程
### 3.1 Windows 系统（Docker Desktop）
1. 打开 Docker Desktop，点击右上角「设置」（齿轮图标）。
2. 在左侧菜单中找到「Docker Engine」，点击进入配置页面。
3. 在配置文件中，找到 `registry-mirrors` 字段，添加国内源地址（格式如下），多个源用逗号分隔：

```json
 {
 "registry-mirrors": [
 "https://docker.mirrors.aliyun.com",
 "https://hub-mirror.c.163.com"
 ],
 "insecure-registries": [],
 "debug": false,
 "experimental": false,
 "features": {
 "buildkit": true
 }
}
```
4. 点击右下角「Apply & Restart」，等待 Docker 重启完成，源更换生效。

### 3.2 macOS 系统（Docker Desktop）
1. 打开 Docker Desktop，点击顶部菜单栏「Docker」→「设置」。
2. 选择左侧「Docker Engine」，进入配置界面（与 Windows 操作一致）。
3. 在 `registry-mirrors` 中添加国内源，保存配置并重启 Docker 即可。

### 3.3 Linux 系统（Ubuntu/Debian/CentOS 通用）
Linux 系统通过修改 Docker 配置文件 `/etc/docker/daemon.json` 实现换源，步骤如下：
1. 打开终端，执行命令创建/编辑配置文件（若文件不存在则自动创建）：
 sudo vim /etc/docker/daemon.json
2. 按 `i` 进入编辑模式，添加以下内容（替换为你选择的国内源）：
```json
 {
 "registry-mirrors": [
 "https://docker.mirrors.aliyun.com",
 "https://hub-mirror.c.163.com"
 ],
 "insecure-registries": [],
 "debug": false,
 "experimental": false,
 "features": {
 "buildkit": true
 }
}
```
3. 按 `Esc`，输入 `:wq` 保存并退出编辑。
4. 重启 Docker 服务，使配置生效：# 重启 Docker 服务
sudo systemctl restart docker
# 查看 Docker 状态，确认重启成功
sudo systemctl status docker

## 四、验证源是否更换成功
无论哪种系统，更换源后可通过以下命令验证，确认镜像源已生效：
docker info
执行命令后，找到「Registry Mirrors」字段，若显示你配置的国内源地址，说明更换成功。

## 五、注意事项
- 若配置多个源，Docker 会按顺序优先使用第一个源，若第一个源不可用，自动切换至下一个。
- 配置时注意 JSON 格式正确，逗号、引号不能遗漏，否则 Docker 无法正常启动（可通过 `sudo systemctl status docker` 查看错误日志）。
- 部分私有镜像仓库（如公司内部仓库），需在 `insecure-registries` 中添加仓库地址，否则无法拉取镜像。
- 若更换源后仍下载缓慢，可尝试清除 Docker 缓存：`docker system prune -a`（谨慎执行，会删除未使用的镜像、容器等）。

## 六、常见问题排查
### 6.1 Docker 重启失败
原因：配置文件 `daemon.json` 格式错误（如逗号缺失、引号不匹配）。
解决：重新编辑配置文件，检查 JSON 格式，确保无误后再次重启。

### 6.2 验证时未显示配置的源
原因：未重启 Docker 服务，或配置文件路径错误（Linux 需确保路径为 `/etc/docker/daemon.json`）。
解决：重启 Docker 服务，重新执行 `docker info` 验证。

### 6.3 下载镜像仍超时
原因：所选源临时维护，或网络存在限制。
解决：切换至其他国内源，或检查网络连接，关闭防火墙/代理后重试。

## 七、总结
更换 Docker 国内源是解决镜像下载慢的关键操作，不同系统操作流程基本一致，核心是修改 Docker 引擎的镜像源配置，重启后即可生效。建议优先选择阿里云、科大等稳定源，确保镜像下载流畅。

Docker 更换国内源教程

本文整理 Windows/macOS 安装 Node.js、配置 npm 国内镜像、使用 cnpm 及常见问题解决方案，用于提升包下载速度。



## 一、Node.js 安装
### 1.1 Windows 系统
1. 访问 [nodejs.org](https://nodejs.org/)，下载 **LTS 版本**
2. 双击安装包，按提示完成安装
3. 验证安装
```bash
node -v
npm -v
```

### 1.2 macOS 系统
#### 方法一：官网安装
1. 下载 `.pkg` 安装包并双击安装
2. 验证版本
```bash
node -v
npm -v
```

#### 方法二：Homebrew 安装
```bash
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Node.js
brew install node
```

---

## 二、npm 国内源配置
### 2.1 配置淘宝镜像（推荐）
1. 临时使用
```bash
npm --registry https://registry.npmmirror.com install 包名
```

2. 永久配置
```bash
npm config set registry https://registry.npmmirror.com
# 验证
npm config get registry
```

3. .npmrc 文件配置（推荐）
```bash
echo "registry=https://registry.npmmirror.com" > .npmrc
```

### 2.2 安装并使用 cnpm
```bash
# 全局安装 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

# 使用 cnpm 安装包
cnpm install 包名

# 查看版本
cnpm -v
```

---

## 三、常用国内镜像源
- 淘宝镜像：`https://registry.npmmirror.com`
- 华为云镜像：`https://mirrors.huaweicloud.com/repository/npm/`
- 腾讯云镜像：`http://mirrors.cloud.tencent.com/npm/`

---

## 四、常见问题解决
### 4.1 下载速度慢
1. 确认已配置国内镜像
2. 清除 npm 缓存
```bash
npm cache clean -f
```

### 4.2 安装包失败
1. 清除缓存
```bash
npm cache clean -f
```

2. 删除依赖与锁文件
```bash
# macOS/Linux
rm -rf node_modules package-lock.json

# Windows
rd /s /q node_modules
del package-lock.json
```

3. 重新安装
```bash
npm install
```

---

## 五、总结
完成配置后可实现：
- Windows/macOS 成功安装 Node.js
- npm 永久切换国内镜像加速下载
- 使用 cnpm 替代 npm 快速安装依赖
- 解决下载慢、安装失败等常见问题