MacOS Catalina下启动Java应用报UnsatisfiedLinkError错误如何解决

这个java.lang.UnsatisfiedLinkError: java.net.NetworkInterface.init()V错误本质是JDK加载MacOS系统原生网络库失败，触发在Spring Cloud组件枚举本地网卡获取主机信息的逻辑中，和MacOS Catalina的安全隔离机制、JDK原生库完整性、系统虚拟网卡异常、IDEA配置错误四类原因相关。

• 方案1：修复JDK权限与完整性
  MacOS Catalina会给未经过公证的应用/开发包添加隔离属性，导致JDK无法加载原生动态库：

  1. 执行命令移除现有损坏的JDK：sudo rm -rf /Library/Java/JavaVirtualMachines/jdk-11.0.12.jdk
  2. 重新下载适配MacOS架构的Eclipse Temurin JDK11安装包并完成安装
  3. 执行命令移除JDK的系统隔离属性：sudo xattr -r -d com.apple.quarantine /Library/Java/JavaVirtualMachines/<替换为你安装的JDK目录名>

• 方案2：临时跳过Spring Cloud网卡探测逻辑
  不需要修改系统配置，直接在IDEA启动参数中添加配置即可规避报错：

  1. 打开IDEA对应Java应用的启动配置页
  2. 在「VM options」输入框中添加如下参数：

  -Dspring.cloud.inetutils.ignored-interfaces=.* -Dspring.cloud.hostname=localhost -Dspring.cloud.ip-address=127.0.0.1
  

  3. 保存配置后重新启动应用即可

• 方案3：修复系统异常网卡
  系统残留的无效虚拟网卡（VPN残留、虚拟机/代理虚拟网卡）会导致JDK枚举网卡时触发原生方法报错：

  1. 打开「系统偏好设置 -> 网络」，删除所有非活跃、无效的虚拟网卡配置
  2. 重启系统后执行ifconfig命令，确认仅保留正常的Wi-Fi/有线网卡配置

• 方案4：校验IDEA项目JDK配置

  1. 打开IDEA -> File -> Project Structure -> SDKs，确认配置的JDK路径指向正常安装的JDK目录，无缺失文件
  2. 打开应用启动配置，确认「Build and run」栏选择的JDK版本和项目配置的JDK版本完全一致，无版本混用

运行如下测试代码，若能正常输出本地网卡名称则说明JDK层面问题已修复：

import java.net.NetworkInterface;
import java.util.Enumeration;

public class NetworkTest {
    public static void main(String[] args) throws Exception {
        Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces();
        while (interfaces.hasMoreElements()) {
            System.out.println("网卡名称：" + interfaces.nextElement().getName());
        }
    }
}

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