一、服务器无法启动或崩溃
- Java环境问题
- 错误现象:提示
Java not found
或版本不兼容。 - 解决方法:
- 安装最新版 Java(官网下载)。
- 确保启动脚本(如
start.bat
)中指定的 Java 路径正确(例如:"C:\Program Files\Java\jdk-17\bin\java.exe"
)。
- 错误现象:提示
- 内存分配不足/过多
- 错误现象:服务器启动时崩溃,提示
OutOfMemoryError
。 - 解决方法:
- 调整启动参数(如
-Xmx4G -Xms2G
),根据物理内存合理分配(建议不超过总内存的 75%)。 - 对于 Mod 服(如 Forge/Fabric),需分配更多内存(建议 6-8G 起步)。
- 调整启动参数(如
- 错误现象:服务器启动时崩溃,提示
- 核心文件损坏/版本冲突
- 错误现象:服务器启动失败,报错涉及
JAR
文件或版本号。 - 解决方法:
- 重新下载官方服务端核心(如
server.jar
或 Forge 安装包)。 - 确保客户端与服务器版本完全一致(例如均为 1.20.1)。
- 重新下载官方服务端核心(如
- 错误现象:服务器启动失败,报错涉及
二、玩家无法连接服务器
- 端口未正确转发
- 错误现象:其他玩家无法通过公网 IP 连接,但本地可访问。
- 解决方法:
- 在路由器设置中转发 TCP/UDP 端口(默认
25565
),并关闭路由器的 SPI 防火墙(部分型号需关闭)。 - 检查服务器
server.properties
中的server-port
是否与转发端口一致。 - 确保服务器使用公网 IP(非内网 IP,如
192.168.x.x
)。可通过 IP查询网站 确认。
- 在路由器设置中转发 TCP/UDP 端口(默认
- 防火墙/杀毒软件拦截
- 错误现象:本地服务器可访问,但外部连接被拒绝。
- 解决方法:
- 在防火墙中允许 Java 或服务器程序通过(Windows:控制面板 → Windows Defender 防火墙 → 允许应用)。
- 临时关闭杀毒软件测试是否为拦截导致。
- 白名单/正版验证设置错误
- 错误现象:玩家被踢出,提示
Not whitelisted
或Invalid session
。 - 解决方法:
- 关闭
server.properties
中的white-list=true
(或手动添加玩家 ID 至whitelist.json
)。 - 正版验证问题:设置
online-mode=false
(离线模式,但需注意安全问题)。
- 关闭
- 错误现象:玩家被踢出,提示
三、服务器运行卡顿或延迟高
- 硬件资源不足
- 现象:TPS(每秒刻数)低于 20,玩家移动卡顿。
- 解决方法:
- 使用
/tps
命令(需插件)查看 TPS,优化实体数量(如减少生物生成、清理掉落物)。 - 升级 CPU(单核性能影响大)或增加内存。
- 使用
- 插件/Mod 冲突
- 现象:安装插件或 Mod 后服务器崩溃或卡顿。
- 解决方法:
- 逐个禁用新增插件/Mod,定位冲突文件。
- 使用性能优化插件(如 Paper 服务端、Spark 性能分析器)。
- 世界文件过大
- 现象:区块加载缓慢,保存世界时卡顿。
- 解决方法:
- 定期删除无用区块(工具:
MCA Selector
)。 - 禁用自动保存(通过插件设置间隔时间)。
- 定期删除无用区块(工具:
四、其他常见问题
- 中文乱码
- 解决方法:在启动脚本中添加
-Dfile.encoding=UTF-8
参数。
- 解决方法:在启动脚本中添加
- 玩家数据丢失
- 原因:异常关闭服务器导致
playerdata
文件损坏。 - 预防:安装自动备份插件(如
AromaBackup
),避免强制关机。
- 原因:异常关闭服务器导致
- DDoS 攻击
- 现象:服务器突然无法连接,CPU/带宽占用激增。
- 解决方法:使用高防服务器或防护服务(如 Cloudflare 的 TCP 屏蔽)。
排查工具与命令
- 查看日志:
- 日志文件
logs/latest.log
会记录错误详情(如插件加载失败原因)。
- 日志文件
- 测试连接:
- 使用
telnet 服务器IP 端口
检查端口是否开放(例:telnet 123.45.67.89 25565
)。
- 使用
- 更新依赖:
- 确保服务器运行库(如 Forge API、Spigot)为最新版本。
推荐优化方案
- 服务端选择:
- 原版服 → Paper(优化性能)→ Purpur(更高自定义)。
- 必备插件:
- 性能监控:
Spark
、Timings
- 防破坏:
CoreProtect
、GriefPrevention
- 管理:
LuckPerms
(权限)、ViaVersion
(多版本支持)
- 性能监控:
遇到具体错误时,建议结合日志内容和社区资源(如 SpigotMC 论坛)进一步排查。