Google App Engine发送邮件失败：缺失API代理问题求助

问题根因 #

你使用的google.appengine.api.mail是App Engine Python 2标准环境的专属旧API，在Python 3+的App Engine环境（无论标准还是灵活环境）中，这套API已被彻底废弃——哪怕你在app.yaml里配置了app_engine_apis: true也无效，因为该配置仅兼容部分旧API，邮件服务不在覆盖范围内，因此会触发找不到API代理的错误。

可行解决方案 #

方案1：用Gmail API发送（官方推荐） #

Python 3的App Engine应用，官方建议使用Gmail API处理邮件发送，步骤如下：

1. 在Google Cloud控制台启用Gmail API
2. 安装所需依赖：

pip install google-api-python-client google-auth-httplib2 google-auth-oauthlib

3. 示例代码（基于服务账号授权，支持自定义发件人）：

from google.oauth2 import service_account
from googleapiclient.discovery import build
from email.mime.text import MIMEText
import base64

# 配置参数
SCOPES = ['https://www.googleapis.com/auth/gmail.send']
SERVICE_ACCOUNT_KEY_PATH = 'path/to/your/service-account.json'
SENDER_EMAIL = 'sender@your-domain.com'  # 需提前配置域范围委派

# 初始化凭证与服务
credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_KEY_PATH, scopes=SCOPES)
delegated_creds = credentials.with_subject(SENDER_EMAIL)
gmail_service = build('gmail', 'v1', credentials=delegated_creds)

def send_order_email():
    # 构建邮件内容
    msg = MIMEText("订单确认邮件正文")
    msg['Subject'] = "您的订单已创建"
    msg['From'] = SENDER_EMAIL
    msg['To'] = 'user@example.com'

    # 编码邮件
    encoded_msg = base64.urlsafe_b64encode(msg.as_bytes()).decode()
    send_request = {'raw': encoded_msg}

    # 发送邮件
    response = gmail_service.users().messages().send(userId="me", body=send_request).execute()
    print(f"邮件发送成功，ID: {response['id']}")

方案2：用SMTP直接发送 #

如果仅需发送到内部管理员邮箱，或使用App Engine自带的发件域名，也可通过SMTP实现：

import smtplib
from email.mime.text import MIMEText

def send_order_email():
    msg = MIMEText("订单确认邮件正文")
    msg['Subject'] = "您的订单已创建"
    msg['From'] = "sender@your-app-id.appspotmail.com"  # 替换为你的App ID
    msg['To'] = 'user@example.com'

    # 连接Gmail的SMTP服务器，App Engine会自动处理身份验证
    with smtplib.SMTP('smtp.gmail.com', 587) as server:
        server.starttls()
        server.login(msg['From'], '')  # 无需填写密码
        server.send_message(msg)

注意：该方式下，发件人必须为your-app-id.appspotmail.com格式，或是已在Google Cloud控制台验证过的自定义域名邮箱。

额外注意点 #

• 彻底移除代码中对google.appengine.api.mail的引用，避免残留报错
• 将用到的Python依赖添加至requirements.txt，确保部署时能正常安装
• 使用Gmail API时，需给服务账号配置域范围委派权限，否则无法模拟发件人发送邮件

内容的提问来源于stack exchange，提问作者jjmurre