OpenSSL在Linux中的常見錯誤及解決方法

以下是OpenSSL在Linux中的常見錯誤及解決方法：

1. 動態庫缺失

   • 錯誤：error while loading shared libraries: libssl.so.x: cannot open shared object file
   • 解決：安裝開發包并更新庫路徑。

     # Debian/Ubuntu  
     sudo apt install libssl-dev  
     # CentOS/RHEL  
     sudo yum install openssl-devel  
     sudo ldconfig  
     

2. 命令未找到

   • 錯誤：openssl: command not found
   • 解決：將OpenSSL安裝路徑加入PATH環境變量。

     export PATH=$PATH:/usr/local/openssl/bin  
     

3. 版本沖突

   • 錯誤：symbol EVP_xxx version OPENSSL_x.x.x not defined
   • 解決：統一OpenSSL庫和頭文件版本，重新編譯安裝。

     cd /usr/local/openssl  
     ./config shared && make && sudo make install  
     

4. 證書驗證失敗

   • 錯誤：SSL handshake failed: certificate verify failed
   • 解決：檢查證書路徑、有效期及配置，設置SSL_CERT_FILE環境變量指向正確證書文件。

5. 配置文件錯誤

   • 錯誤：OpenSSL configuration file not found
   • 解決：復制默認配置文件到指定路徑（如/etc/ssl/openssl.cnf）。

     sudo cp /usr/share/doc/openssl/examples/openssl.cnf /etc/ssl/  
     

6. 依賴缺失

   • 錯誤：編譯時提示缺少libxslt、perl等依賴
   • 解決：安裝對應開發包。

     # Debian/Ubuntu  
     sudo apt install libxslt-dev perl-dev  
     # CentOS/RHEL  
     sudo yum install libxslt-devel perl-devel  
     

7. 套接字/文件描述符錯誤

   • 錯誤：socket: Bad file descriptor
   • 解決：檢查文件描述符限制，調整系統或進程限制，確保網絡連接正常。

通用建議：通過openssl version驗證安裝，使用strace或ldd排查庫依賴問題，查看日志文件（如/var/log/syslog）獲取詳細錯誤信息。