App Engine非默认服务无法接收邮件，求解决方案

以下是针对该问题的具体排查和解决步骤：

• 确认邮件接收地址格式
  非默认服务的邮件接收地址必须遵循格式：收件人@[服务ID].[项目ID].appspotmail.com，比如你的服务是my_email_service、项目ID为my-project，正确收件地址应为test@my_email_service.my-project.appspotmail.com。若仍使用默认的@my-project.appspotmail.com，请求只会路由到默认服务，非默认服务无法接收。

• 检查app.yaml配置正确性
  确保my_email_service的app.yaml包含以下关键配置：

  runtime: python39  # 对应你使用的Python版本
  service: my_email_service
  inbound_services:
    - mail  # 必须开启此项才能接收邮件
  handlers:
    - url: /_ah/mail/.+  # 匹配所有邮件请求路径
      script: auto
      login: admin  # App Engine强制要求邮件处理路由需管理员权限
  

  注意：Python 3环境下script: auto会自动映射到main.py中的WSGI应用，需确保你的main.py已实现POST /_ah/mail/<email>的处理逻辑。

• 验证dispatch.yaml部署
  正确的dispatch.yaml需将所有邮件请求路由到my_email_service，配置示例：

  dispatch:
    - url: "*/_ah/mail/*"
      service: my_email_service
  

  部署时必须单独执行命令：gcloud app deploy dispatch.yaml，仅部署服务不会更新路由规则。

• 确认服务部署状态
  执行gcloud app services list，检查my_email_service的状态是否为RUNNING。另外，直接访问服务的邮件路径（如https://my_email_service-dot-my-project.uc.r.appspot.com/_ah/mail/），若返回405 Method Not Allowed说明handler配置生效；若返回404，则需检查app.yaml的handler规则是否有误。

• 排查日志和权限

  1. 前往Cloud Logging，使用过滤条件：resource.type="gae_app" AND resource.labels.service="my_email_service" AND logName="projects/[项目ID]/logs/appengine.googleapis.com%2Frequest_log"，查看是否存在邮件请求记录。若无记录，说明请求未路由到该服务，需回到地址和路由配置环节复查。
  2. 确保服务默认服务账号拥有Cloud Storage写入权限，比如添加Storage Object Creator角色，避免因权限问题导致邮件内容无法存入Storage（此类问题会在日志中出现权限报错）。

• 测试验证
  发送测试邮件到正确的非默认服务邮件地址，随后检查Cloud Logging的请求日志，同时查看Storage对应存储桶是否生成邮件内容文件。

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