python連接minio報錯‘SSL routines‘,‘ssl3_get_record‘,‘wrong version number‘的解決方法

更新時間：2026年01月13日 14:51:54 作者：detayun

這篇文章主要為大家詳細介紹了python連接minio報錯‘SSL routines‘,‘ssl3_get_record‘,‘wrong version number‘的解決方法,文中的示例代碼講解詳細,有需要的小伙伴可以了解下

錯誤原因分析

1.核心錯誤：OpenSSL.SSL.Error: [('SSL routines', 'ssl3_get_record', 'wrong version number')]

這通常表示客戶端嘗試用SSL/TLS協(xié)議連接到一個實際上并未使用SSL/TLS的端口，或者協(xié)議版本不匹配。

2.連接信息：你正在嘗試連接到 119.84.128.79:39000

這是一個非標準的HTTPS端口（通常HTTPS使用443端口）
MinIO默認使用9000端口（HTTP）和9001端口（HTTPS）

3.可能的原因：

MinIO服務(wù)器實際上在39000端口上運行的是HTTP服務(wù)，但你的客戶端嘗試用HTTPS連接
SSL/TLS協(xié)議版本不兼容
防火墻或代理干擾了SSL握手

MinIO服務(wù)器配置問題

解決方案

方案1：檢查MinIO服務(wù)器配置（最可能）

首先確認你的MinIO服務(wù)器實際配置：

檢查MinIO是否啟用了HTTPS：

# 登錄到MinIO服務(wù)器，檢查運行參數(shù)
ps aux | grep minio

查看是否包含--address ":39000"和--ssl相關(guān)參數(shù)

嘗試用curl測試連接：

# 測試HTTP連接
curl -v http://119.84.128.79:39000

# 測試HTTPS連接
curl -v https://119.84.128.79:39000

# 如果服務(wù)器使用自簽名證書
curl -v -k https://119.84.128.79:39000

根據(jù)測試結(jié)果調(diào)整客戶端代碼：

如果39000端口是HTTP，修改MinIO客戶端初始化代碼：

from minio import Minio

# 改為使用http而不是https
minio_client = Minio(
    '119.84.128.79:39000',
    access_key='your-access-key',
    secret_key='your-secret-key',
    secure=False  # 禁用SSL
)

方案2：檢查網(wǎng)絡(luò)和代理設(shè)置

確認沒有代理干擾：

import os
# 確保沒有設(shè)置不正確的代理
os.environ['NO_PROXY'] = '119.84.128.79'

嘗試禁用SSL驗證（僅測試用）：

from minio import Minio
from urllib3 import disable_warnings
from urllib3.exceptions import InsecureRequestWarning

disable_warnings(InsecureRequestWarning)

minio_client = Minio(
    '119.84.128.79:39000',
    access_key='your-access-key',
    secret_key='your-secret-key',
    secure=True  # 保持為True，但我們將禁用驗證
)

# 強制禁用SSL驗證（不推薦生產(chǎn)環(huán)境使用）
import ssl
minio_client._http.ssl_context = ssl._create_unverified_context()

方案3：更新相關(guān)庫

pip install --upgrade minio urllib3 pyOpenSSL

方案4：檢查MinIO服務(wù)器SSL證書

如果MinIO確實配置了HTTPS，但使用自簽名證書：

獲取服務(wù)器證書：

openssl s_client -connect 119.84.128.79:39000 -showcerts </dev/null 2>/dev/null | openssl x509 -outform PEM > minio.crt

在客戶端代碼中指定證書：

import ssl
from minio import Minio

# 創(chuàng)建自定義SSL上下文
ssl_context = ssl.create_default_context(cafile='path/to/minio.crt')

minio_client = Minio(
    '119.84.128.79:39000',
    access_key='your-access-key',
    secret_key='your-secret-key',
    secure=True,
    ssl=ssl_context
)