常见异常

通常，用户在使用 Geyser 时会遇到无法连接到服务器类似的错误，这个页面帮助你尝试解决这些异常。如果你仍然没有解决，请不妨加入 我们的 Discord 以获得支持。

Floodgate

有关 Floodgate 的帮助，请见: 这里。

控制台报错

无法获取本地附件缓存 Unrecognized token 'Read': was expecting (JSON String, Number, Array, Object or token 'null', 'true' or 'false') at [Source: (String)"Read timed out"; line: 1, column: 5] 非法的本地下载和加载请求: zh_cn

每次开启Geyser前自行给服务器搭建能够垂直向上攀爬的工具连接海外代理下载，或者加入首页提供的群的群文件下载别人下载好的语言文件放入locates。 这最多导致服务器内语言文件丢失，跟无法进入服务器没有半毛钱关系。

无法正常连接到服务器! (服务器在好友选项卡没有显示或者在连接服务器时出现 "无法连接到世界")

• 如果你不使用像 TCPShield 的反向代理，请保证你的 enable-proxy-protocol 选项是设置为 false 的。

如果服务器没有在好友选项卡显示

• 如果你使用的是 Windows 10, iOS, 或者 Android: 尝试以添加服务器形式连接。

• 如果你使用的是 Xbox One: 尝试使用 BedrockConnect 连接。

• 如果你使用的是 PS4: 请使用使用一个 LAN 代理

• 如果你使用的是 Nintendo Switch: 目前没有方法可以使用好友选项卡连接，但你仍然可以使用 BedrockConnect 以添加服务器形式连接。

如果 Geyser 服务器就在本地：尝试将 localhost 或者 0.0.0.0 作为IP，以添加服务器形式进行连接。如果这没有效果，或者你的 Geyser 服务器不在同一个电脑，那么请使用：你 本地 的 IPv4 地址。

点击这里 以修复 "无法连接至世界" 且后台无报错

在启动时提示 java.net.BindException: Address already in use: bind

这代表 Geyser 服务器所开设的端口已被占用，请确保你关闭了所有占用该端口的软件，然后再试。如果这没有起作用，通常重启你的电脑即可解决该问题。

[...] has been compiled by a more recent version of the Java Runtime (class file version 60.0)

点击这个链接以了解如何升级到 Java 16: https://paper.readthedocs.io/en/latest/java-update/index.html.

您的服务商可能没有及时打开UDP端口

这通常和你的主机端的端口有关。最常见的是，跟Java版的常用的 TCP 协议的端口不同，你的主机很有可能没有开放基岩版所使用的 UDP 协议的端口。一个确认此问题的方法是关闭你的服务器，然后选择其他 基岩版服务端，例如 Nukkit（你不一定非要用 Nukkit）以检查是否是该问题导致的。

卡在 "正在连接服务器" 且后台没有报错

你或许需要升级你的 Java，如果确实是这样，请访问 AdoptOpenJDK.net。

有时这会发生在网络较差的环境中。 Geyser 配置中有一个 mtu 选项； 慢慢降低这个数字（以 100 为基准），每次修改后重新启动，并重新测试加入。

如果您收到“无法连接到世界”而没有提示新的连接的控制台记录，则此选项很可能没有作用。

登录失败

如果你正在使用一个插件版本： 在你的 Geyser 配置，将你的 bedrock 的 ip 设置为 127.0.0.1。

Cannot reply to EncryptionRequestPacket without profile and access token

出现这个消息一般有两个原因:

Floodgate 问题:

如果您配置启用了 Floodgate 可能会出现此消息。 通常，这意味着您的 Floodgate 配置是错误的，或与其他插件冲突。如果您曾将 Floodgate 的密钥文件复制到 同一服务器 上的 Geyser 文件夹，那么 Geyser 文件夹内的密钥文件就是多余的。您可以放心的删除复制到 Geyser 文件夹中的密钥文件，重新启动服务器。

服务器是正版模式而你的 Geyser 设置的是离线模式:

如果你的配置如上所述，那么简单来说，Geyser 自然不会正常运作。如果你将服务器设置为正版认证，那么你的 Geyser 配置也应该是相同的。 正版认证的服务器将会要求您使用 Java正版账户 进行登录认证，如果你在登陆 Geyser 的时候没有使用正版账户认证，那么你将无法加入服务器。如果你的配置没有问题却仍然遇到这个报错，那么有可能是您的登录凭据无效（如密码错误）或者是连接正版认证服务器时连接超时。

Connection Refused: <INSERT IP AND/OR DOMAIN>

连接被拒绝通常意味着请求该端口时无法连接 Java 服务器，或者服务器拒绝访问网络级别的外部连接。后者可能会发生在类似 TCPShield 等 DDOS 防护插件上，如果您没有类似的 DDOS 防护插件，请确保您尝试连接的服务器连接 IP 或域名在配置中拼写正确，已启动且端口转发正确。

如果您从旧版本的 Geyser 进行更新，请将您的远程地址设置为auto，然后重试。

Floodgate Misconfiguration

请查看 这个页面 查看更多信息

Mojang Resetting Account Credentials

不幸的是，这是我们无法控制的事情，当您在服务器上将 Geyser 作为插件运行，很可能出现这种情况，异地登陆会让 Mojang 判定您的账户可能被盗号，并因此重置登录凭据。 如果您在本地运行 Geyser，这不应该发生。我们推荐由我们制作的插件 Floodgate, 它允许基岩版客户端在不需要 Java 版帐户的情况下加入您的服务器。 点击了解这个插件 以获得更多帮助。

基岩版客户端提示 "无效IP地址"

目前尚不清楚为什么，即使对于有效的域名也会发生这种情况。尝试使用 IPv4 地址。

基岩版客户端在使用指令时出现卡顿或者崩溃

在你的 Geyser 配置文件中关闭 command-suggestions 选项。 关闭这个设置后基岩版玩家将无法进行命令补全，但是可以防止因此造成的游戏卡顿或崩溃。 如果你是服务器的管理员，你可以准备一份命令白名单让玩家使用， 这将会把非必要的命令从TAB补全中移除，对于Java版玩家来说也是一样。他还有其他好处。这是一个可以做到此功能的插件： CommandWhitelist

BungeeCord 在基岩版玩家加入后卡顿或者崩溃

请确保你的 BungeeCord 的 config.yml 配置文件中将 ip-forward 设置为 true 并在你的所有子服的 spigot.yml 配置文件中将 bungeecord 设置为 true。

Failed to load locale asset cache: Unrecognized token 'Cannot'

这与启动时无法下载区域设置文件相关的任何其他内容通常是由 java 尝试使用 IPv6 连接而 Mojang 仅使用 IPv4 引起的，因此使用在启动命令添加此标识来固定使用ipv4： -Djava.net.preferIPv4Stack=true, 就像这样: java -Xms1024M -Djava.net.preferIPv4Stack=true -jar Geyser.jar

Outdated client! Please use 1.x.x

Java 版服务器太新，Geyser 对它来说有点旧了。请确保你的 Geyser 是最新版本，如果是，请耐心等待 Geyser 完成更新。

Outdated server! I'm still on 1.x.x

更新你的 Java 版服务器或者使用 ViaVersion 插件。 你也可以尝试 VIAaaS。

Query: Incorrect Magic!

看这里： https://www.spigotmc.org/threads/query-incorrect-magic-and-high-cpu-usage.159386/#post-2709057

*如果您不使用 TCPShield 等反向代理，请确保将 enable-proxy-protocol 设置为 false.

只在安装 Floodgate 的 BungeeCord 服务器上有效

如果您使用 Floodgate，请确保将其安装在所有 Spigot 子服上，如下所示：

1. Bungee: Geyser 和 Floodgate

2. 大厅: floodgate

3. 子服-1: floodgate

4. 子服-2: floodgate 其他的同理。

5. 请保证你的 key.pem 和 config.yml 在所有的服务器上使用的是相同的配置。

如果您的玩家无法从大厅连接到另一个子服，请检查控制台。

可能造成该问题的插件：

• HamsterAPI