gmail 已禁用“低安全性应用访问”，导致传统 imap 密码登录失效；本文详解如何通过开启两步验证并生成应用专用密码，安全、合规地使用 php imap_open 连接 gmail。
gmail 已禁用“低安全性应用访问”，导致传统 imap 密码登录失效；本文详解如何通过开启两步验证并生成应用专用密码，安全、合规地使用 php imap_open 连接 gmail。
Google 自 2022 年起全面停用「低安全性应用访问」（Less Secure App Access），这意味着直接使用 Gmail 账户密码通过 imap_open() 连接 IMAP 服务（如 imap.gmail.com:993/imap/ssl）将失败，并返回类似 AUTHENTICATIONFAILED 的错误。
✅ 正确且官方推荐的解决方案是：启用两步验证（2-Step Verification） + 使用应用专用密码（App Password）替代账户密码。
✅ 操作步骤（Gmail 账户端）
- 登录 Google 账户安全设置页
- 开启 「两步验证」（需先绑定手机或验证器应用）
- 启用后，向下滚动至 「应用专用密码」 区域（路径：Security → 2-Step Verification → App passwords）
- 点击生成 → 选择应用类型为 「邮件」，设备名称可填 PHP-IMAP → 点击「生成」
- 复制生成的 16 位一次性密码（如 abcd efgh ijkl mnop，注意不含空格）——该密码即为你在代码中使用的 password
✅ 更新 PHP 代码（关键修改）
// ❌ 错误：直接使用 Gmail 账户密码（已失效）
// $imap = imap_open("{imap.gmail.com:993/imap/ssl}INBOX", $_POST['username'], $_POST['password']);
// ✅ 正确：使用应用专用密码（去除空格，全小写）
$appPassword = str_replace(' ', '', $_POST['app_password']); // 如 "abcdefg...mnop"
$imap = imap_open("{imap.gmail.com:993/imap/ssl}INBOX", $_POST['username'], $appPassword);
if (!$imap) {
die('IMAP 连接失败：' . imap_last_error());
}
echo "✅ Gmail IMAP 连接成功！";⚠️ 注意事项：
- 应用专用密码仅在启用两步验证后可用，且每个密码仅限单次使用场景；
- 不要将应用密码硬编码在脚本中，建议通过环境变量或安全配置文件加载；
- 若更换设备、重置两步验证或删除该密码，需重新生成；
- Gmail 默认仅允许通过 IMAP 访问「已归档」或「收件箱」等标准文件夹；如需访问标签（Label），需映射为邮箱路径，例如：{imap.gmail.com:993/imap/ssl}INBOX 或 {imap.gmail.com:993/imap/ssl}[Gmail]/Sent（注意空格与方括号）；
- 建议搭配 imap_errors() 和 imap_alerts() 进行错误诊断，提升调试效率。
通过上述配置，你即可在符合 Google 安全策略的前提下，稳定、安全地使用 PHP IMAP 扩展读取 Gmail 邮件，无需依赖第三方代理或 OAuth2 复杂流程（适用于简单自动化读信场景）。
