Purpur 1.18.2服务器安装插件启动报Invalid plugin.yml错误求助

运行Purpur 1.18.2（Java 17）版本的Minecraft服务器时，安装任何新插件都会触发启动报错，已尝试修改编码但无法解决，报错日志如下：

org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPluginLoader.java:186) ~[purpur-api-1.18.2-R0.1-SNAPSHOT.jar:?]
at org.bukkit.plugin.SimplePluginManager.loadPlugins(SimplePluginManager.java:159) ~[purpur-api-1.18.2-R0.1-SNAPSHOT.jar:?]
at org.bukkit.craftbukkit.v1_18_R2.CraftServer.loadPlugins(CraftServer.java:418) ~[purpur-1.18.2.jar:git-Purpur-1632]
at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:323) ~[purpur-1.18.2.jar:git-Purpur-1632]
at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1180) ~[purpur-1.18.2.jar:git-Purpur-1632]
at net.minecraft.server.MinecraftServer.lambda$spin$1(MinecraftServer.java:321) ~[purpur-1.18.2.jar:git-Purpur-1632]
at java.lang.Thread.run(Thread.java:833) ~[?:?]
Caused by: java.util.zip.ZipException: invalid END header (bad central directory offset)
at java.util.zip.ZipFile$Source.zerror(ZipFile.java:1598) ~[?:?]
at java.util.zip.ZipFile$Source.initCEN(ZipFile.java:1492) ~[?:?]
at java.util.zip.ZipFile$Source.<init>(ZipFile.java:1315) ~[?:?]
at java.util.zip.ZipFile$Source.get(ZipFile.java:1277) ~[?:?]
at java.util.zip.ZipFile$CleanableResource.<init>(ZipFile.java:709) ~[?:?]
at java.util.zip.ZipFile.<init>(ZipFile.java:243) ~[?:?]
at java.util.zip.ZipFile.<init>(ZipFile.java:172) ~[?:?]
at java.util.jar.JarFile.<init>(JarFile.java:347) ~[?:?]
at java.util.jar.JarFile.<init>(JarFile.java:318) ~[?:?]
at java.util.jar.JarFile.<init>(JarFile.java:284) ~[?:?]
at org.bukkit.plugin.java.JavaPluginLoader.getPluginDescription(JavaPluginLoader.java:174) ~[purpur-api-1.18.2-R0.1-SNAPSHOT.jar:?]
6 more

解决方案 #

• 重新下载插件jar包：报错核心是ZipException，说明插件文件损坏，重新从官方渠道下载，校验文件大小与官方提供的一致，避免下载中断导致文件不完整
• 更换服务器核心：重新下载Purpur 1.18.2官方服务器核心，确保核心文件未损坏
• 检查Java环境：使用官方Oracle OpenJDK 17或Adoptium Temurin 17，避免使用修改版Java导致jar解析异常
• 修复文件权限：确保服务器进程对plugins文件夹拥有完整的读写权限，避免因权限不足无法读取插件文件
• 清理缓存文件：删除服务器目录下的cache等临时缓存文件夹，再重新启动服务器

内容的提问来源于stack exchange，提问作者Jake