解决LWJGL中JNI版本不支持与GLFW窗口创建崩溃问题-java教程-PHP中文网

解决LWJGL中JNI版本不支持与GLFW窗口创建崩溃问题

本文旨在解决lwjgl开发中常见的“unsupported jni version detected”警告及随后的原生代码崩溃问题，特别是当其与`glfwcreatewindow`函数调用不当相关时。核心问题在于`glfwcreatewindow`的第四个参数被错误地传入了窗口属性常量，而非预期的监视器指针。通过将该参数修正为`null`，可以有效避免程序崩溃，并确保glfw窗口的正确初始化。

在基于LWJGL进行Java游戏开发时，开发者可能会遇到一个令人困惑的错误：“Unsupported JNI version detected, this may result in a crash.” 紧随其后的是一个致命的Java虚拟机崩溃，通常表现为EXCEPTION_ACCESS_VIOLATION。尽管错误信息提示JNI版本问题，但实际上，这往往是由于对GLFW API的误用导致的，尤其是在调用glfwCreateWindow函数时。

深入理解glfwCreateWindow函数

glfwCreateWindow是GLFW库中用于创建新窗口的核心函数。其函数签名通常如下：

GLFWwindow* glfwCreateWindow(int width, int height, const char* title, GLFWmonitor* monitor, GLFWwindow* share);

该函数接受五个参数：

width: 窗口的初始宽度。
height: 窗口的初始高度。
title: 窗口的标题字符串。
monitor: 如果要创建全屏窗口，此参数应指向要使用的监视器对象。如果创建的是窗口模式的窗口，此参数应为NULL。
share: 如果要共享资源（如纹理、顶点缓冲区对象等）给另一个窗口的上下文，此参数应指向要共享的窗口。否则，此参数应为NULL。

错误根源分析

在出现“Unsupported JNI version detected”并伴随崩溃的情况下，常见的问题在于glfwCreateWindow的第四个参数（monitor）被错误地传入了一个窗口提示常量，例如GLFW_RESIZABLE。GLFW_RESIZABLE是一个窗口提示（Window Hint），用于通过glfwWindowHint函数设置窗口的属性，例如窗口是否可调整大小。它是一个整数值，而非一个GLFWmonitor指针。

当将GLFW_RESIZABLE这样的整数值作为指针传递给期望GLFWmonitor*的参数时，Java虚拟机在尝试通过JNI调用原生C函数时，会因为指针无效而导致内存访问冲突，进而引发EXCEPTION_ACCESS_VIOLATION。尽管错误信息提及JNI版本，但其根本原因在于原生函数接收到了一个非法的指针地址，导致了程序在原生层面的崩溃。

解决方案

解决此问题的关键在于确保glfwCreateWindow的参数类型和值与API预期严格匹配。对于窗口模式的应用程序，第四个参数（monitor）应该明确设置为NULL。窗口的可调整大小等属性应通过glfwWindowHint函数在创建窗口之前进行设置。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

错误示例代码：

// 错误：将GLFW_RESIZABLE作为监视器参数传入
window = glfwCreateWindow(windowWidth, windowHeight, "Game", GLFW_RESIZABLE, NULL);

正确示例代码：

// 正确：第四个参数（监视器）设置为NULL，窗口属性通过glfwWindowHint设置
glfwDefaultWindowHints(); // 重置所有窗口提示为默认值
glfwWindowHint(GLFW_VISIBLE, GLFW_FALSE); // 窗口初始不可见
glfwWindowHint(GLFW_RESIZABLE, GLFW_TRUE); // 窗口可调整大小

window = glfwCreateWindow(windowWidth, windowHeight, "Game", NULL, NULL);

通过将glfwCreateWindow的第四个参数从GLFW_RESIZABLE更改为NULL，可以消除导致JNI层崩溃的非法指针访问。

注意事项与最佳实践

仔细阅读API文档： 在使用任何库（尤其是涉及原生调用的库）时，务必仔细阅读其官方API文档，理解每个函数的参数含义、类型和预期值。
区分窗口提示与函数参数： glfwWindowHint用于在窗口创建前设置窗口的属性，而glfwCreateWindow的参数则用于定义窗口的基本特性（如尺寸、标题、是否全屏及资源共享）。
调试原生崩溃： 当遇到EXCEPTION_ACCESS_VIOLATION这类原生崩溃时，首先检查最近修改过的涉及原生调用的代码。错误的参数传递是常见的崩溃原因。
JDK与LWJGL版本匹配： 尽管本例的根本原因并非版本不匹配，但在其他情况下，确保JDK版本与LWJGL库版本兼容也是避免潜在问题的关键。LWJGL通常会对其支持的JDK版本有明确说明。

总结

“Unsupported JNI version detected”警告及随后的EXCEPTION_ACCESS_VIOLATION崩溃在LWJGL开发中，特别是与glfwCreateWindow函数相关时，通常是由于monitor参数被错误地传入了窗口提示常量（如GLFW_RESIZABLE）而非NULL或有效的GLFWmonitor指针。通过将glfwCreateWindow的第四个参数修正为NULL，可以有效解决此问题，确保GLFW窗口的稳定创建。理解并正确使用API是避免此类问题的根本之道。