树莓派3B安装rplay时遇libWFC.so共享库加载错误求助

云上老周

2026-5-25

Fixing "libWFC.so: cannot open shared object file" Error When Installing rplay on Raspberry Pi 3B

Hey there, I’ve dealt with exactly this kind of shared library hiccup on Raspberry Pi devices before—let’s walk through how to fix it.

The error means your system can’t locate the libWFC.so library that rplay depends on to run. Here’s what to try, in order:

First, check if the library is already on your Pi
Run this command to search every directory for libWFC.so:
```
sudo find / -name libWFC.so 2>/dev/null
```
If it spits out a path (like /usr/local/lib/libWFC.so), move straight to the next step. If not, you need to install the library. Start with the package manager—this often works for rplay dependencies:
```
sudo apt update && sudo apt install libwfc-dev
```
If that package doesn’t exist, you’ll have to compile it from source alongside rplay. Make sure you follow rplay’s official build docs closely—they usually list all required dependencies you need to grab first.
Update the system’s library cache
If the library exists but the system can’t find it, we need to tell Linux where to look:
1. Add the library’s directory to the system’s library path. For example, if it’s in /usr/local/lib, run:
```
echo "/usr/local/lib" | sudo tee /etc/ld.so.conf.d/rplay.conf
```
2. Refresh the shared library cache to apply the change:
```
sudo ldconfig
```
This should make the system recognize libWFC.so the next time you launch rplay.
Double-check permissions (if needed)
If you still get the error after the above steps, make sure the library file has the right permissions so all users can read it:
```
sudo chmod 644 /path/to/libWFC.so
```
Just replace /path/to/ with the actual directory you found earlier.