# 常见问题

> For the complete documentation index, see [llms.txt](https://simbot.forte.love/llms.txt).

## 包引用异常/找不到注解/无法引用注解

如果你发现你的代码所有simbot相关的内容都出现了包引用异常，并且它们的特点是：

* 你使用的IDE是 IntelliJ IDEA，而且版本不是最新的。

* 你实际正常引入了相关的依赖，也可以在依赖树/库中找到对应的类，换言之警告的类实际上是存在的。

* 红色警告附着在类上，而不是某个包路径节点上。

* 强行运行的话是可正常运行的。

例如图例所示:

![FAQ-包引用异常.png](images/FAQ-%E5%8C%85%E5%BC%95%E7%94%A8%E5%BC%82%E5%B8%B8.png)

> **Tip:**
> 图例用的是simbot3时代的截图，但是本质上都是一样的，不用纠结截图中的详细代码。

那么这通常是因为Kotlin插件版本过低而导致类型无法解析。

> **Tip:**
> 如果你不是在使用 IntelliJ IDEA 的情况下出现上述问题， 也可以尝试下列解决方案。如果不行，可以前往 [反馈与贡献](feedback-and-support.html) 交流或反馈详细情况。

那么你可以：

### 1.更新IDEA

你需要确保你的IDEA的版本不能太落后，至少要在当前最新版本的三个小版本范围内。 举个例子，假如目前IDEA的最新版本为 `2023.1`，那么你现在使用的IDEA至少也得是 `2022.1+`。

> **Tip: 仅是猜测**
> 三个小版本范围的说法其实只是凭感觉，无依据，不绝对。总而言之，IDEA的版本越新越好。

### 2.禁用Kotlin插件

如果你真的不想更新IDEA，那么你可以尝试禁用IDEA的 `Kotlin` 插件， 如果你不打算也没有使用Kotlin的话。只要你编写的语言不是 `Kotlin`，那么禁用掉此插件也是可以使用simbot的。

> **Tip:**
> 但是这样也可能使得一些由 Kotlin 而来的异常/警告检测失效， 比如尝试在 Java 中引用 `internal` 级别的类型。

## 如何主动获取Bot/主动发送消息

在非事件的情况下（例如一个定时任务或初始化任务），你可以通过构建的 `Application` 获取到 `BotManagers`， 而又可以通过各个 `BotManager` 进一步获取到你想要的 `Bot`。

Kotlin:

```KOTLIN
val application: Application = ... // 你的 Application
// 可以得到 BotManagers
val botManagers = application.botManagers

// 你可以选择直接使用 allBots()、firstBot() 等辅助API来遍历或快捷获取某种bot
botManagers.allBots().forEach { bot -> ... }

// 也可以自行遍历，精准选择你所需要的bot
for (botManager in botManagers) {
    // 假设这里你想要寻找QQ机器人的BotManager
    if (botManager is QQGuildBotManager) {
        // 找到指定 appid 的bot，
        // 然后你可以保存、操作，或者做点儿什么。
        val bot = botManager[123456789.ID]
        
        // 你已经找到了你需要的bot，结束循环
        break
    }
}
```

Java:

```JAVA
var application = ...; // 你的 Application
// 可以得到 BotManagers
var botManagers = application.getBotManagers();
// 你可以选择直接使用 allBots()、firstBot() 等辅助API来遍历或快捷获取某种bot
botManagers.allBots().iterator().forEachRemaining(bot -> { ... });

// 也可以自行遍历，精准选择你所需要的bot
for (var botManager : botManagers) {
    // 假设这里你想要寻找QQ机器人的BotManager
    if (botManager instanceof QQGuildBotManager qgBotManager) {
        // 找到指定 appid 的bot，
        // 然后你可以保存、操作，或者做点儿什么。
        var bot = qgBotManager.get(Identifies.of(123456789));

        // 你已经找到了你需要的bot，结束循环
        break;
    }
}
```

在集成 Spring 的情况下获取 `Application`，你可以参考: [获取 Application、BotManager 或 Bot](spring-boot.html#get-bot) 。

而对于主动发送消息，当你拿到了 Bot，就可以用来获取其中的行为对象了（比如群、频道等）， 届时即可直接使用它们的 `send` API 进行发送。

## ClassNotFoundException: kotlin.enums.EnumEntriesKt

> **Tip: 相关参考**
> * [Discussions#183](https://github.com/orgs/simple-robot/discussions/183)

出现此问题，你大概率在通过 Maven 工具使用 Spring Boot，且版本大概率是 2.x 。 在Maven中，Spring Boot 的 `spring-boot-parent` 会通过 `properties` 标签中的 `kotlin.version` 控制一个 Kotlin 的版本， 有关这种版本管理的说明，你可以参考Spring官方文档的这些内容：

* [Spring Boot 3.3+ 文档: Kotlin Support / Dependency Management](https://docs.spring.io/spring-boot/3.3.3/reference/features/kotlin.html#features.kotlin.dependency-management)

* [Spring Boot 3.2及以下 (包括 2.x) 文档: Dependency Versions / Version Properties](https://docs.spring.io/spring-boot/docs/3.2.9/reference/html/dependency-versions.html#appendix.dependency-versions.properties) (有需要可自行更改链接路径中的版本号)

因此，在Maven中如果想要修复此问题，使用 `properties` 为属性 `kotlin.version` 指定一个较高的 Kotlin 版本即可。

> **Note:**
> 你可以指定为当前simbot版本 5.0.0-Alpha2 所使用的 Kotlin 版本 2.4.21 或更高版本。

```XML
<properties>
    <kotlin.version>2.4.21</kotlin.version>
</properties>
```

如果你的情况与上述不同，可前往 [讨论区](https://github.com/orgs/simple-robot/discussions) 或 [issues](https://github.com/simple-robot/simpler-robot/issues) 反馈详情。

## Bot 已启动但没有收到事件

可以按下面的顺序检查：

1. 查看启动日志，确认 Bot 已注册并启动。使用 Spring Boot 时，检查 `.bot.json` 文件路径和组件标识是否准确。

2. 确认平台端具备所需权限（如有，例如 QQ 组件），并已订阅对应事件。OneBot 这类需要第三方服务端的还需要检查事件 WebSocket 地址和协议服务是否可访问。

3. 确认监听器被注册或被 Spring 扫描到，事件类型与平台实际推送的类型相匹配。

4. 如果配置了过滤条件，检查消息内容和条件是否匹配。可以先监听更通用的事件类型观察接收到的事件。

各平台的配置入口见 [选择组件库](start-use-components.html)。有关事件处理器的注册方式，参见 [事件监听与处理](basic-event-listener.html)。

## QQ机器人组件监听不到群聊消息

首先确保你配置了沙箱群（如果是测试环境），并启动成功无误。

然后，检查你配置中的 `config.intents` 的值 是否包含群聊相关 的事件的订阅值。

由于群聊相关的事件不是默认的，因此你需要自行添加对其的订阅配置。

你可以在 [《QQ机器人 - Bot配置文件 - intents》](component-qq-guild-bot-config.html#config.intents) 中了解到更多。