使用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
相关产品推荐
相关产品推荐

