一、前言

在現(xiàn)代開發(fā)場景中，自動化處理電子郵件已經(jīng)是很多系統(tǒng)的剛需：客服系統(tǒng)自動收取郵件、財務(wù)自動獲取賬單郵件、個人寫一個郵件歸檔腳本等等。除了 IMAP 協(xié)議，另一個常見的郵件收取協(xié)議就是 POP3（Post Office Protocol version 3）。

Python 內(nèi)置的 poplib 模塊，為我們提供了簡單直接的 POP3 客戶端接口。雖然相比 imaplib，POP3 的功能相對有限（主要是收取，而不是在服務(wù)器上同步和管理），但在輕量級應(yīng)用場景中，poplib 足夠高效和實用。

本文將帶你從 POP3 協(xié)議 出發(fā)，逐步掌握 Python poplib 的核心用法，配合 完整代碼案例，并在最后分享最佳實踐與常見問題排查。

二、POP3 協(xié)議與 poplib 簡介

2.1 POP3 協(xié)議概述

POP3（Post Office Protocol 3）是電子郵件客戶端與郵件服務(wù)器之間的標(biāo)準(zhǔn)協(xié)議之一，主要功能是 從服務(wù)器下載郵件。常見特性：

• 默認(rèn)端口 110（明文連接）。
• POP3 over SSL/TLS 通常使用端口 995。
• POP3 的設(shè)計哲學(xué)：郵件一旦下載，就存儲在本地，服務(wù)器端可選擇保留或刪除。
• 與 IMAP 的對比：
  • POP3：偏向下載 + 本地存儲（輕量、簡單）。
  • IMAP：偏向同步 + 服務(wù)器存儲（多終端一致）。

2.2 poplib 簡介

Python 標(biāo)準(zhǔn)庫中的 poplib 模塊提供了 POP3 客戶端功能。主要特性：

• 建立與 POP3 服務(wù)器的連接。
• 登錄郵箱。
• 獲取郵件列表。
• 下載郵件內(nèi)容。
• 刪除郵件。

主要類和方法：

• poplib.POP3(host, port=110, timeout=None)：普通連接。
• poplib.POP3_SSL(host, port=995, timeout=None)：SSL 加密連接。
• user() / pass_()：登錄。
• stat()：獲取郵件統(tǒng)計。
• list()：獲取郵件列表。
• retr(msg_id)：下載指定郵件。
• dele(msg_id)：刪除郵件。
• quit()：斷開連接。

三、環(huán)境準(zhǔn)備

3.1 郵箱設(shè)置

和 IMAP 一樣，大多數(shù)郵箱服務(wù)商在 POP3 功能上都有額外要求：

1. 開啟 POP3 服務(wù)（如 QQ 郵箱要在設(shè)置中啟用 POP3）。
2. 生成授權(quán)碼（通常不能用真實密碼，必須用應(yīng)用專用密碼）。

3.2 Python 環(huán)境

由于 poplib 是標(biāo)準(zhǔn)庫，無需安裝額外依賴。但解析郵件正文與附件時，通常需要配合：

• email：解析郵件內(nèi)容。
• base64 / quopri：解碼郵件正文。
• os：保存附件。

四、poplib API 詳解

4.1 建立連接

import poplib

# 普通連接
pop_conn = poplib.POP3("pop.example.com", 110)

# SSL 加密連接
pop_conn = poplib.POP3_SSL("pop.example.com", 995)

常用端口：

• 110 → 普通 POP3
• 995 → POP3 over SSL

4.2 登錄

pop_conn.user("username@example.com")
pop_conn.pass_("password_or_token")

4.3 獲取服務(wù)器狀態(tài)

print(pop_conn.stat())  
# 返回 (郵件數(shù)量, 郵件總字節(jié)數(shù))

4.4 獲取郵件列表

resp, mails, octets = pop_conn.list()
print(mails)
# mails = [b'1 1024', b'2 2048', ...]

4.5 下載郵件

resp, lines, octets = pop_conn.retr(1)
msg_content = b"\r\n".join(lines).decode("utf-8", "ignore")

4.6 刪除郵件

pop_conn.dele(1)  # 刪除第 1 封郵件

4.7 斷開連接

pop_conn.quit()

五、完整實戰(zhàn)案例

5.1 獲取最新一封郵件

import poplib
from email.parser import Parser

pop_conn = poplib.POP3_SSL("pop.qq.com")
pop_conn.user("your_email@qq.com")
pop_conn.pass_("your_auth_code")

# 郵件數(shù)量
num_messages = len(pop_conn.list()[1])
print("總郵件數(shù):", num_messages)

# 獲取最后一封郵件
resp, lines, octets = pop_conn.retr(num_messages)
msg_content = b"\r\n".join(lines).decode("utf-8", "ignore")

msg = Parser().parsestr(msg_content)
print("主題:", msg["Subject"])
print("發(fā)件人:", msg["From"])
print("收件人:", msg["To"])

pop_conn.quit()

5.2 遍歷收取所有郵件

from email.header import decode_header

for i in range(1, num_messages + 1):
    resp, lines, octets = pop_conn.retr(i)
    msg_content = b"\r\n".join(lines).decode("utf-8", "ignore")
    msg = Parser().parsestr(msg_content)

    subject, encoding = decode_header(msg["Subject"])[0]
    if isinstance(subject, bytes):
        subject = subject.decode(encoding or "utf-8", "ignore")
    print(f"[{i}] 主題: {subject}")

5.3 提取正文與附件

import os
from email import message_from_string

msg = message_from_string(msg_content)

for part in msg.walk():
    content_type = part.get_content_type()
    disposition = part.get("Content-Disposition")

    if content_type == "text/plain" and not disposition:
        body = part.get_payload(decode=True).decode("utf-8", "ignore")
        print("正文:", body)

    if disposition and "attachment" in disposition:
        filename = part.get_filename()
        if filename:
            filepath = os.path.join("downloads", filename)
            with open(filepath, "wb") as f:
                f.write(part.get_payload(decode=True))
            print("保存附件:", filepath)

5.4 批量保存郵件信息到 CSV

import csv

rows = []
for i in range(1, num_messages + 1):
    resp, lines, octets = pop_conn.retr(i)
    msg_content = b"\r\n".join(lines).decode("utf-8", "ignore")
    msg = Parser().parsestr(msg_content)

    rows.append([i, msg.get("From"), msg.get("Subject")])

with open("emails.csv", "w", newline="", encoding="utf-8") as f:
    writer = csv.writer(f)
    writer.writerow(["ID", "From", "Subject"])
    writer.writerows(rows)

六、最佳實踐

1. 推薦使用 SSL：POP3 明文連接存在安全風(fēng)險。
2. 使用授權(quán)碼：避免暴露真實密碼。
3. 合理批量拉取：POP3 只支持按順序獲取郵件，建議分頁處理。
4. 清理資源：每次操作完成后調(diào)用 quit()。
5. 異常處理：捕獲 poplib.error_proto 錯誤，保證健壯性。

七、常見問題與排查

登錄失敗

• 檢查是否開啟了 POP3 服務(wù)。
• 確認(rèn)是否使用授權(quán)碼而不是郵箱登錄密碼。

中文亂碼

• 郵件頭常用 Base64/QP 編碼，需 decode_header() 解析。

附件丟失

• 郵件多為 MIME 格式，需 msg.walk() 遍歷所有部分。

連接超時

• 使用 poplib.POP3_SSL(host, port, timeout=60) 設(shè)置超時。

八、進階應(yīng)用與擴展

• 結(jié)合 smtplib：實現(xiàn)郵件收發(fā)一體化。
• 結(jié)合數(shù)據(jù)庫：將郵件存入 MySQL/SQLite 方便檢索。
• 結(jié)合調(diào)度工具：如 schedule 或 APScheduler 定時收取郵件。
• 結(jié)合 NLP：分析郵件內(nèi)容，自動分類或提取關(guān)鍵信息。

九、總結(jié)

本文系統(tǒng)介紹了 POP3 協(xié)議 的原理與特點，并結(jié)合 Python poplib 庫 的 API，展示了從登錄、收取、解析到附件提取的完整流程。同時，還分享了常見問題與最佳實踐。

相比 imaplib，poplib 的功能更輕量，適用于只需 簡單收取郵件 的場景。如果你需要更強大的 郵件管理與同步，可以優(yōu)先考慮 IMAP。但在快速開發(fā)腳本、批量收取郵件等任務(wù)中，poplib 仍然是一把利器。

以上就是Python通過poplib庫實現(xiàn)POP3郵件收取的完整流程的詳細內(nèi)容，更多關(guān)于Python POP3郵件收取的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論