作为经常在树莓派上折腾Java项目和MC服务器的人，我完全懂你这种被本地库链接错误搞疯的感觉！结合你描述的问题——32位Pi OS跑不起来、UnsatisfiedLinkError、新出现的No such file or directory，咱们一步步拆解解决：

第一步：先换掉32位Raspberry Pi OS #

现在绝大多数Java GPIO库（包括Pi4J v2.x、pigpio的官方绑定）对64位系统的支持远好于32位，尤其是树莓派4B/5这类新机型，32位系统本身就会限制硬件性能，还容易出现架构不匹配的库问题。

• 用Raspberry Pi Imager重新刷系统，选择「Raspberry Pi OS (Bookworm) 64-bit」（带桌面或Lite版都可以，Lite更适合服务器）
• 刷完后记得启用SSH、设置静态IP（方便远程管理），并完成系统初始化更新：

  sudo apt update && sudo apt full-upgrade -y
  

第二步：彻底清理并重新安装GPIO依赖 #

之前的旧依赖可能残留了32位的库，或者版本不兼容，咱们彻底重来：

1. 卸载旧的GPIO工具链：

   sudo apt remove --purge pigpio wiringpi -y
   sudo apt autoremove -y
   

2. 安装最新的pigpio（Java GPIO库大多依赖它）：

   sudo apt install pigpio -y
   # 启用pigpio服务，确保开机自启
   sudo systemctl enable pigpio && sudo systemctl start pigpio
   

3. 针对Pi4J（推荐用v2.x，v1.x已经停止维护）：
   如果用Maven，在pom.xml里引入正确的64位依赖：

   <dependencies>
       <dependency>
           <groupId>com.pi4j</groupId>
           <artifactId>pi4j-core</artifactId>
           <version>2.6.0</version>
       </dependency>
       <dependency>
           <groupId>com.pi4j</groupId>
           <artifactId>pi4j-platform-raspberrypi</artifactId>
           <version>2.6.0</version>
       </dependency>
       <!-- 如果你需要用pigpio的原生绑定 -->
       <dependency>
           <groupId>com.pi4j</groupId>
           <artifactId>pi4j-library-pigpio</artifactId>
           <version>2.6.0</version>
       </dependency>
   </dependencies>
   

   Gradle的话对应调整依赖配置即可。

第三步：确保Java环境与系统架构匹配 #

这是最容易忽略的点——如果系统是64位，但Java装的是32位，必然会出现库找不到的错误：

• 检查当前Java架构：

  java -version
  

  输出里如果有aarch64就是64位，arm32则是32位。
• 如果是32位Java，卸载重装64位版本：

  sudo apt remove openjdk-* -y
  sudo apt install openjdk-17-jdk -y # Bookworm默认的LTS版本，稳定可靠
  

第四步：解决「No such file or directory」与UnsatisfiedLinkError #

这两个错误本质都是Java找不到对应的本地.so库，或者权限不够：

1. 验证本地库是否存在：
   用find命令查找pigpio的库文件：

   find /usr/lib -name "libpigpio*.so"
   

   64位系统下应该输出/usr/lib/aarch64-linux-gnu/libpigpio.so之类的路径，如果找不到，说明pigpio安装失败，回到第二步重新安装。

2. 指定Java库路径（如果需要）：
   运行Java程序时，手动指定本地库的搜索路径，确保Java能找到：

   java -Djava.library.path=/usr/lib/aarch64-linux-gnu/ -jar your-discord-bot.jar
   

3. 权限问题：
   GPIO操作需要特殊权限，要么用sudo运行机器人，要么把当前用户加入gpio组：

   sudo usermod -aG gpio your-username
   

   执行后注销再登录，或者重启系统，这样不用sudo也能访问GPIO。

第五步：极简测试排除干扰 #

先别着急整合Discord机器人和MC服务器，写一个极简的GPIO测试程序，验证环境是否正常：

import com.pi4j.Pi4J;
import com.pi4j.io.gpio.digital.DigitalOutput;
import com.pi4j.io.gpio.digital.DigitalState;

public class SimpleGpioTest {
    public static void main(String[] args) {
        // 初始化Pi4J上下文
        var pi4j = Pi4J.newAutoContext();
        // 创建GPIO18的输出引脚（接个LED测试）
        var led = DigitalOutput.create(pi4j, 18);
        
        // 点亮LED
        led.state(DigitalState.HIGH);
        System.out.println("LED已点亮，2秒后熄灭");
        
        try {
            Thread.sleep(2000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
        
        // 熄灭LED
        led.state(DigitalState.LOW);
        // 关闭Pi4J上下文
        pi4j.shutdown();
    }
}

编译运行这个程序，如果能正常控制LED，说明GPIO环境没问题，再把逻辑整合到你的Discord机器人里就好。

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