You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用IntelliJ启动Minecraft时持续报错:UnsatisfiedLinkError问题

解决IntelliJ启动Minecraft时的LWJGL加载错误

这个UnsatisfiedLinkError我太熟了——说白了就是JVM找不到LWJGL需要的本地原生库文件(Windows下是.dll,Mac是.dylib,Linux是.so),给你几个靠谱的解决步骤:

1. 检查依赖配置(构建工具用户优先)

如果你用Maven或Gradle管理项目,别只加LWJGL的核心jar,必须同时引入对应操作系统的原生库依赖:

  • Gradle示例配置(根据你的系统替换natives后缀):
dependencies {
    // 核心LWJGL组件
    implementation 'org.lwjgl:lwjgl:3.3.2'
    implementation 'org.lwjgl:lwjgl-glfw:3.3.2'
    implementation 'org.lwjgl:lwjgl-opengl:3.3.2'
    // 对应系统的原生库:Windows用natives-windows,Mac用natives-macos,Linux用natives-linux
    runtimeOnly 'org.lwjgl:lwjgl:3.3.2:natives-windows'
    runtimeOnly 'org.lwjgl:lwjgl-glfw:3.3.2:natives-windows'
    runtimeOnly 'org.lwjgl:lwjgl-opengl:3.3.2:natives-windows'
}
  • Maven的话,要在<dependency>里加<classifier>标签指定原生库平台,比如:
<dependency>
    <groupId>org.lwjgl</groupId>
    <artifactId>lwjgl</artifactId>
    <version>3.3.2</version>
    <classifier>natives-windows</classifier>
    <scope>runtime</scope>
</dependency>

2. 手动指定Java库路径(IntelliJ运行配置)

如果构建工具的配置没问题,或者你是手动导入的库,直接在启动配置里给JVM指定原生库位置:

  • 打开Run > Edit Configurations,找到你的Minecraft启动项
  • 在VM options里添加:
-Djava.library.path=/path/to/your/lwjgl/natives

路径可以是你本地Maven/Gradle仓库里的natives目录,比如Windows下可能是C:\Users\你的用户名\.m2\repository\org\lwjgl\lwjgl\3.3.2\natives-windows,或者你项目里手动存放原生库的文件夹。

3. 手动导入库的额外配置

如果是手动把LWJGL的jar拖进项目的:

  • 不仅要把核心jar加到Project Structure > Libraries,还要把对应系统的natives文件夹里的所有文件,放到项目里的某个目录(比如src/main/resources/natives)
  • 右键这个natives目录,选择Mark Directory as > Native Library Location,让IntelliJ自动识别这些原生库。

4. 最后验证步骤

  • 先执行Build > Clean Project清理旧的构建文件
  • 再执行Build > Rebuild Project重新构建
  • 然后启动Minecraft试试,大概率能解决这个错误。

内容的提问来源于stack exchange,提问作者Mijasch

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 04:10:52