本地方法栈溢出由JNI引用误用引发时，本质是native层栈帧失控增长；需结合极浅堆栈含native方法、hs_err日志SIGSEGV、jstack显示_thread_in_native等特征确认，并从JNI引用管理、系统栈限制及第三方库行为协同排查。
本地方法栈溢出若由跨语言原生调用（如 JNI）中误用方法引用引发，本质是 native 层栈帧失控增长，而非 Java 虚拟机栈问题。它不响应 -Xss 调整，需从 native 调用链、引用生命周期和系统资源三方面协同定位。
确认是否为 native 方法引用误用所致
关键看错误现象是否具备以下组合特征：
- 抛出
java.lang.StackOverflowError，但堆栈深度极浅（通常 ≤ 5 层），顶层方法含native标识，例如Java_java_nio_Bits_copyToArray、Java_org_sqlite_core_NativeDB_column_text或自定义 JNI 函数名； - 或 JVM 直接崩溃，生成
hs_err_pid*.log，其中siginfo: si_signo = 11 (SIGSEGV)，且Stack:区域显示重复的 native 函数调用帧（如连续多行libxxx.so+0x12345）； -
jstack输出中对应线程状态为_thread_in_native，堆栈为空或仅含JavaThread "xxx" [_thread_in_native, id=...]，无任何 Java 方法帧。
重点检查 JNI 方法引用使用模式
JNI 中误用 jobject、jclass 等局部引用（Local Reference）是常见诱因，尤其在循环或递归 native 调用中未及时释放：
- 在 native 方法内反复调用
env->GetObjectClass()、env->GetMethodID()等获取引用，却未用env->DeleteLocalRef()显式清理，导致 native 层引用表持续膨胀，间接加剧栈帧管理开销； - 在
PushLocalFrame()/PopLocalFrame()块外创建大量局部引用，或嵌套调用中未配对使用，使引用无法自动回收； - 将 Java 对象的弱全局引用（
NewWeakGlobalRef）误当强引用长期持有，并在 native 回调中反复反向调用 Java 方法，形成隐式递归调用链。
验证 native 调用上下文与资源限制
操作系统线程栈大小直接约束 native 方法栈容量，需同步排查：
- Linux 下执行
ulimit -s查看当前线程默认栈大小（常为 8192 KB），尝试临时增大：ulimit -s 16384后复现问题，若不再崩溃，说明原栈尺寸不足； - JVM 启动时添加
-XX:NativeMemoryTracking=detail，再用jcmd <pid> VM.native_memory summary观察Internal和Thread类别内存是否异常增长； - 用
perf record -e syscalls:sys_enter_mmap,syscalls:sys_enter_munmap -p <pid>捕获 mmap/munmap 频次，若出现高频配对调用，可能反映 DirectByteBuffer 或 native 库在频繁申请/释放堆外内存，触发底层栈敏感操作。
聚焦第三方 native 组件行为
许多“方法引用误用”实为第三方库内部逻辑缺陷，需针对性核查：
- Netty epoll transport：检查是否使用了已知存在栈耗尽问题的旧版本（如 4.1.99 及更早），升级至 4.1.100+ 可规避
epollWait调用栈异常增长； - SQLite JDBC native driver：确认未在单个 native 调用中循环读取大量列（如
column_text在 while 循环内未释放 column 引用），应改用批量接口或显式sqlite3_column_text+sqlite3_free； - OpenCV / FFmpeg Java binding：避免在 native 回调函数（如 Mat 处理回调）中再次触发 Java 层方法调用，尤其不能递归调用自身或触发新 JNI 调用链。
