Linux 共享庫路徑配置三大方式：LD_LIBRARY_PATH、ldconfig、rpath

程式運行時動態鏈接器需找到共享庫，Linux 提供三種層級的庫路徑配置方式，適用場景各異。

1. 環境變數 LD_LIBRARY_PATH（臨時、用戶級）

export LD_LIBRARY_PATH=/usr/lib64:/opt/app/lib

• 優點：即時生效、無需 root、適合開發測試、臨時覆蓋系統庫。
• 缺點：僅對當前 Shell 及子進程有效，重新登入失效；生產環境不建議長期依賴。

2. /etc/ld.so.conf + ldconfig（永久、系統級）

echo "/usr/lib64" >> /etc/ld.so.conf
ldconfig

• 原理：ldconfig 掃描配置文件列出的目錄，構建緩存 /etc/ld.so.cache，運行時動態鏈接器直接查緩存。
• 優點：一次配置、全局生效、持久化、標準做法。
• 缺點：需 root 權限；修改後必須執行 ldconfig 更新緩存。

補充：/etc/ld.so.conf.d/*.conf 目錄下的文件也會被自動包含，建議將第三方庫路徑寫入獨立 .conf 文件，便於管理。

3. 編譯時嵌入 -Wl,-rpath（程式級、最高優先級）

gcc -Wl,-rpath=/usr/lib64 -o myapp main.c

• 原理：將運行時搜索路徑硬編碼進 ELF 二進制文件的 DT_RPATH 或 DT_RUNPATH 動態段。
• 優點：程式自帶路徑、無環境依賴、部署簡單（配合 $ORIGIN 相對路徑可實現可遷移部署）。
• 缺點：編譯時決定、修改需重新編譯；硬編碼絕對路徑會降低可移植性。

進階技巧：-Wl,-rpath='$ORIGIN/../lib' 使用 $ORIGIN 表示可執行文件所在目錄，實現相對路徑查找庫，解決部署路徑不固定問題。

優先級順序（高→低）

1. DT_RPATH (編譯期 -rpath，若無 DT_RUNPATH)
2. LD_LIBRARY_PATH
3. DT_RUNPATH (編譯期 -rpath，新版 ld 默認生成)
4. /etc/ld.so.cache (由 ldconfig 生成)
5. 預設路徑 /lib、/usr/lib、/lib64、/usr/lib64

排查工具

# 查看程式依賴庫及解析路徑
ldd /path/to/binary
# 查看動態段 RPATH/RUNPATH
readelf -d /path/to/binary | grep -E 'RPATH|RUNPATH'
# 手動指定庫路徑運行
LD_LIBRARY_PATH=/custom/lib ./binary

最佳實踐建議

• 系統級庫：/etc/ld.so.conf.d/ + ldconfig。
• 應用級私有庫：編譯時 -Wl,-rpath='$ORIGIN/../lib'，部署時將庫放在 lib/ 同級目錄。
• 開發調試：臨時 export LD_LIBRARY_PATH。
• 避免在生產環境全局濫用 LD_LIBRARY_PATH，易引發版本衝突、安全風險。

理解三種方式的層級、優先級與適用場景，能快速解決「庫找不到」、「載入錯誤版本」等經典動態鏈接問題。