Google App Engine无法接收邮件：本地正常部署后异常求助

我之前也碰到过类似本地正常、线上失效的情况，咱们一步步来梳理可能的问题：

1. 先确认邮件接收的目标地址合法性 #

本地开发环境的dev_appserver.py允许你用任意邮箱地址（比如anything@example.com）测试，但生产环境的App Engine只接收发送到你项目专属域名的邮件：

• 用默认域名的话，地址格式应该是xxx@<你的项目ID>.appspotmail.com
• 用自定义域名的话，需要先在Cloud Console完成域名验证和邮件接收配置，地址格式是xxx@你的自定义域名.com
  你本地测试用的anything@example.com在生产环境完全无效，这很可能是核心问题！

2. 检查app.yaml的线上配置 #

• 确认app.yaml里的邮件路由规则正确部署，比如：

  handlers:
  - url: /_ah/mail/.+
    script: handle_incoming_email.php
    login: admin
  

  要保证url规则覆盖所有邮件接收路径，script指向正确的PHP文件，且login权限配置符合需求。
• 检查部署的版本是否为默认版本，有时候部署后没设置默认，访问的还是旧版本配置。

3. 查看生产环境的详细日志 #

本地日志只能反映模拟环境情况，线上的真实错误需要去Google Cloud Console查看：

1. 进入你的App Engine项目
2. 打开「日志」页面，筛选/_ah/mail/相关请求
3. 查看是否有500错误、权限报错或脚本执行异常的日志，这些信息能直接定位问题。

4. 验证PHP环境兼容性 #

• 确保app.yaml指定的PHP版本和本地开发环境一致，比如：

  runtime: php74
  

  不同PHP版本的语法或扩展支持可能有差异，导致线上脚本执行失败。
• 检查线上是否启用了脚本需要的PHP扩展，比如邮件处理相关扩展。

5. 权限配置检查 #

默认情况下App Engine服务账号拥有邮件接收权限，但如果修改过IAM配置，可能导致权限缺失：

• 进入Cloud Console的「IAM与管理员」页面
• 找到App Engine默认服务账号（格式一般是<项目ID>@appspot.gserviceaccount.com）
• 确保它拥有App Engine Mail Receiver或相关权限。

你本地的日志显示：
INFO: hello from handle_incoming_email
INFO 2018-02-22 23:13:33,985 module.py:835] default: "POST /_ah/mail/anything@example.com HTTP/1.1" 200 555
这说明本地的路由和脚本执行都正常，重点要排查线上的地址合法性和配置一致性。

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