若未收到WorkBuddy绑定QQ邮箱的验证码邮件，需依次排查：一、检查垃圾邮件并添加发件人至白名单；二、确认SMTP地址为smtp.qq.com、端口465配SSL/TLS；三、开启QQ邮箱SMTP服务并使用新生成的16位授权码；四、清理邮箱使容量低于85%；五、在云服务器安全组中放行TCP 465端口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成WorkBuddy安装并尝试绑定QQ邮箱，但始终未收到验证码邮件，则可能是由于邮件服务配置错误或SMTP服务端限制所致。以下是排查与修复该问题的具体步骤：
一、检查垃圾邮件文件夹与过滤规则
验证码邮件常被邮箱服务商自动归类为垃圾邮件，尤其当发送方域名未被信任时，系统可能直接隔离该类邮件而不提示用户。
1、登录您的QQ邮箱网页版，点击左侧菜单栏的【垃圾邮件】。
2、在垃圾邮件列表中搜索发件人为“no-reply@workbuddy.ai”或类似系统通知地址的邮件。
3、若发现该邮件，勾选后点击【设为重要邮件】，再点击【移至收件箱】。
4、进入【设置】>【反垃圾邮件】>【白名单】，添加 no-reply@workbuddy.ai 及 smtp.qq.com 到信任发件人列表。
二、验证SMTP服务器参数与端口加密方式
WorkBuddy依赖正确配置的SMTP服务发送验证邮件，若服务器地址、端口或加密协议不匹配，将导致连接建立失败或认证被拒绝，从而无法发出验证码。
1、确认SMTP服务器地址是否为 smtp.qq.com，不可填写 imap.qq.com 或 pop.qq.com。
2、确认端口是否为 465，且加密方式必须选择 SSL/TLS；若误选端口587，则需同步切换为STARTTLS加密模式。
3、在WorkBuddy的邮箱配置界面中，重新输入完整参数，避免粘贴时混入不可见空格或全角字符。
三、核查QQ邮箱SMTP授权码有效性与启用状态
授权码是QQ邮箱用于第三方应用登录的核心凭证，其失效、过期或未开启对应服务将直接阻断邮件发送链路。
1、登录QQ邮箱网页版，进入【设置】>【账户】，滚动至【POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务】区域。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、确认【SMTP服务】右侧显示为“已开启”，若为灰色“未开启”，请勾选并完成短信验证。
3、向下查找【生成授权码】按钮，点击后获取新授权码；若此前授权码已复制丢失，旧码立即失效，必须使用新生成的16位授权码。
4、将新授权码完整填入WorkBuddy配置项，注意区分字母O与数字0、小写l与数字1。
四、检测邮箱存储空间与接收能力
当QQ邮箱容量达到上限时，服务器将拒绝接收任何新邮件，包括系统自动发送的验证码邮件，此时无错误提示但实际投递失败。
1、登录QQ邮箱网页版，查看页面右上角显示的邮箱容量百分比（如“已用 4.95GB / 5GB”）。
2、若使用率 ≥ 95%，点击【清理邮箱】>【一键清理】，优先删除【已删除邮件】与【垃圾邮件】文件夹中的全部内容。
3、返回【收件箱】，手动刷新页面，确认容量回落至 85%以下 后再重试验证码发送。
五、排除公有云环境网络策略限制
若WorkBuddy部署于阿里云、腾讯云等公有云服务器，其默认安全组策略通常禁止出站SMTP连接，导致邮件请求在传输层即被拦截，表现为“连接超时”或“无响应”。
1、登录云平台控制台，进入【云服务器ECS】>【安全组】>【配置规则】。
2、在【出方向】规则中，新增一条放行规则：协议类型为 TCP，端口范围为 465/465，目标地址为 0.0.0.0/0。
3、保存后，在服务器终端执行测试命令：telnet smtp.qq.com 465，若返回“Connected”，说明网络链路已通。
