Python連接MySQL報錯:缺少cryptography庫的解決辦法

更新時間：2026年06月04日 11:04:08 作者：XYiFfang

這篇文章主要介紹了Python連接MySQL報錯:缺少cryptography庫的兩種解決辦法,分別是安裝cryptography庫和修改MySQL用戶認證方式,兩種方法各有適用場景,需要的朋友可以參考下

發(fā)現(xiàn)問題

在使用 Python 連接 MySQL 數(shù)據(jù)庫時，有時可能會遇到這樣的錯誤：

RuntimeError: 'cryptography' package is required for sha256_password or caching_sha2_password auth methods

這篇文章將帶你快速理解該錯誤的原因，并提供兩種實用的解決方法。

MySQL 8.0 及以上版本默認使用 caching_sha2_password 或 sha256_password 認證插件進行用戶身份驗證，這兩種方式比早期的 mysql_native_password 更安全。

而 PyMySQL 默認不包含對這兩種認證方式的支持，需要依賴 cryptography 這個第三方加密庫來完成密碼的加密處理。如果沒有安裝該庫，就會出現(xiàn)上述錯誤。

如果你有權限安裝 Python 包，這是最直接的解決方法。

pip install cryptography

安裝完成后重新運行你的 Python 腳本即可。

適用場景：

如果你有數(shù)據(jù)庫管理員權限，可以將用戶認證方式改為傳統(tǒng)的 mysql_native_password。

執(zhí)行以下SQL語句（請?zhí)鎿Q用戶名和密碼）：

ALTER USER '用戶名' IDENTIFIED WITH mysql_native_password BY '密碼';
FLUSH PRRIVILEGES;

適用場景：

方法	優(yōu)點	缺點	適用場景
安裝 cryptography	安全、官方推薦、一勞永逸	需安裝額外依賴	開發(fā)、測試、生產(chǎn)
修改認證方式	無需安裝新包、快速解決	安全性降低、需數(shù)據(jù)庫權限	臨時測試、內網(wǎng)環(huán)境