From ad48c9dd2f7d6cc04c0c809a356ecf53c6c11b5b Mon Sep 17 00:00:00 2001
From: DarkPath <3120931286@qq.com>
Date: Mon, 9 Jun 2025 20:56:53 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=20Apollo=20=E7=89=88?=
 =?UTF-8?q?=E6=9C=AC=E5=85=BC=E5=AE=B9=E6=80=A7=E8=AF=B4=E6=98=8E=E5=8F=8A?=
 =?UTF-8?q?=E6=9B=B4=E6=96=B0=E6=8F=90=E9=86=92=E7=9F=AD=E4=BF=A1=E5=9B=BE?=
 =?UTF-8?q?=E7=A4=BA=EF=BC=8C=E4=BC=98=E5=8C=96=E7=94=A8=E6=88=B7=E6=8E=92?=
 =?UTF-8?q?=E6=9F=A5=E6=8C=87=E5=BC=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../课程10：使用Spigot开服/90-常见问题合集.md       | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/mcguide/27-网络游戏/课程10：使用Spigot开服/90-常见问题合集.md b/mcguide/27-网络游戏/课程10：使用Spigot开服/90-常见问题合集.md
index 8215641..546d8af 100644
--- a/mcguide/27-网络游戏/课程10：使用Spigot开服/90-常见问题合集.md
+++ b/mcguide/27-网络游戏/课程10：使用Spigot开服/90-常见问题合集.md
@@ -74,6 +74,19 @@ time: 60分钟
 
 - 请检查BC服与Spigot服配置以及日志，确定BC服能正常连接上Spigot服
 
+### (5) 排查 Apollo 版本兼容性问题
+
+- 当客户端与服务端的 Apollo 版本不一致（例如客户端为 3.1.0，而服务端为 3.0.0）时，玩家将无法进入游戏，界面会一直停留在“正在链接外部服务器”，同时 Geyser 日志中不会有任何输出。
+
+- 请确保客户端与服务端使用的是相同版本，以避免因版本不兼容导致连接失败的问题。
+
+- 可能您会疑惑：“我怎么知道什么时候需要更新 Apollo 版本呢？”
+
+  建议您在收到类似下图的 **开发包更新提醒短信或站内信** 时，**及时将开发环境中的服务器更新到最新的开发版本**，以确保当正式版本发布时能够顺利对接，避免出现严重兼容性问题，导致玩家无法连接或难以及时修复。
+  ![问题1-9](./res/quest11.png)
+  
+- 在正式版本发布后，通常也会通过类似短信或站内信的方式通知您进行更新。**此外，请务必前往“编辑更新”中的“上传网络游戏”界面，在“适用版本”选项中勾选对应的新版本**，以确保玩家可以正常进入服务器。
+
 ## 6、SpigotMaster是否必须加载?
 目前Spigotmaster是强制要求加载，虽然不加载不会报错，但是会有部分功能无法支持。如皮肤防作弊、聊天插件控制、商城接口等。因此强烈要求必须加载SpigotMaster
 **另外目前SpigotMaster不支持reload指令，使用后会不正常，建议不使用Spigot等端的reload指令**