常见问题 | Simple Robot

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

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

你使用的IDE是 IntelliJ IDEA，而且版本不是最新的。
你实际正常引入了相关的依赖，也可以在依赖树/库中找到对应的类，换言之警告的类实际上是存在的。
红色警告附着在类上，而不是某个包路径节点上。
强行运行的话是可正常运行的。

例如图例所示:

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

那么你可以：

1.更新IDEA

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

2.禁用Kotlin插件

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

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

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

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
    }
}

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。

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

ClassNotFoundException: kotlin.enums.EnumEntriesKt

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

Spring Boot 3.3+ 文档: Kotlin Support / Dependency Management
Spring Boot 3.2及以下 (包括 2.x) 文档: Dependency Versions / Version Properties
(有需要可自行更改链接路径中的版本号)

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

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

如果你的情况与上述不同，可前往讨论区或 issues 反馈详情。

Bot 已启动但没有收到事件

可以按下面的顺序检查：

查看启动日志，确认 Bot 已注册并启动。使用 Spring Boot 时，检查 .bot.json 文件路径和组件标识是否准确。
确认平台端具备所需权限（如有，例如 QQ 组件），并已订阅对应事件。OneBot 这类需要第三方服务端的还需要检查事件 WebSocket 地址和协议服务是否可访问。
确认监听器被注册或被 Spring 扫描到，事件类型与平台实际推送的类型相匹配。
如果配置了过滤条件，检查消息内容和条件是否匹配。可以先监听更通用的事件类型观察接收到的事件。

各平台的配置入口见选择组件库。有关事件处理器的注册方式，参见事件监听与处理。

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

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

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

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

你可以在《QQ机器人 - Bot配置文件 - intents》中了解到更多。