2026.11.06

WordPress 寄信出問題，如何查 wp_mail 發信紀錄與排除錯誤？

網站表單顯示已送出，管理員卻收不到通知；或使用者回報沒有收到密碼重設信。這時先確認 WordPress 是否有把郵件交給發信流程，再檢查郵件設定與錯誤訊息。WP Mail Logging 可查看透過 wp_mail 處理的郵件紀錄，協助縮小問題範圍；紀錄存在不代表郵件已送達收件匣。

先確認問題發生在哪一段

請先記下問題發生時間、觸發郵件的操作、收件地址網域，以及網站上是否出現錯誤。若問題只發生在特定表單，也記下表單名稱與提交時間。避免用真實使用者資料反覆測試；可以改用自己控制的測試信箱，並避免在公開畫面貼出郵件本文或錯誤紀錄。

安裝並查看 wp_mail 紀錄

以具備外掛管理權限的帳號登入 WordPress 後台，前往「外掛」新增外掛，搜尋 WP Mail Logging，核對外掛名稱與作者資訊後安裝並啟用。也可從官方外掛頁確認目前版本與說明。
用網站原本會寄信的功能觸發一封測試信，例如聯絡表單或密碼重設。使用可存取的測試信箱，不要用客戶名單做測試。
在後台開啟 WP Mail Logging 的紀錄頁，依時間找到剛才的測試郵件。核對收件地址、主旨、時間與狀態；如果頁面顯示錯誤訊息，先抄錄必要文字，不要把含個資的完整郵件內容貼到公開討論區。
若完全找不到該筆紀錄，確認操作確實觸發寄信，並檢查該功能或網站程式是否使用 WordPress 的 wp_mail。繞過這個流程的寄信不一定會出現在此外掛紀錄中。
若紀錄指出發信流程遇到錯誤，逐項核對寄件者地址、主機郵件設定、SMTP 外掛或主機提供的發信方式。修正一項後再寄一封測試信，避免一次更動多個設定而無法判斷原因。

實際驗證與判讀界線

測試時同時查看三處：網站是否建立紀錄、紀錄是否顯示錯誤、測試信箱是否實際收到郵件。收到信後也檢查垃圾郵件匣與郵件標頭中的寄件資訊。若外掛有紀錄但信箱沒收到，代表郵件曾進入 WordPress 的發信流程，不能據此判定郵件已被郵件伺服器接受、送達或未被退信；後續仍須檢查主機郵件紀錄、SMTP 服務商回報或收件端狀態。若紀錄有錯誤，依錯誤內容與主機或郵件服務商文件處理，不要猜測外掛沒有顯示的送達狀態。

隱私、保留與清理

郵件可能含姓名、聯絡資料、訂單資訊，或可用來重設密碼的連結。只讓必要的管理員查看紀錄，並避免透過截圖或匯出檔散布內容。若外掛設定頁或目前版本文件提供保留期設定，依實際可用選項設定必要期間；不要假設未確認的清理功能存在。停用外掛前，先查看該版本的官方說明與網站資料庫清理規則，確認停用後紀錄是否保留、如何刪除及是否需要備份，再依網站的資料保留政策處理。停用本身不應被當成已清除歷史紀錄的證明。