Indy IMAP读取SENT文件夹行长度超限错误及SearchKey筛选咨询

触发原因 #

该异常和skAll搜索键没有直接关系，触发根源是Indy组件默认设置了单行响应内容的最大读取长度（默认值为16384字节）。读取SENT根文件夹时报错、子文件夹正常，是因为SENT根文件夹内邮件存量大，IMAP服务端返回的UID SEARCH查询结果是单行拼接的所有匹配邮件UID，总长度超过了Indy默认的行长度上限；子文件夹邮件数量少，返回的UID列表长度没碰阈值，就不会报错。
之前更换其他SearchKey后不报错但查不到邮件，本质是用了错误的筛选条件，命中的邮件数为0，返回内容极短自然不会触发长度限制，不是skAll本身有问题。

修复方法 #

• 最直接的修复：在初始化IMAP连接、调用搜索接口前，手动调高IOHandler的最大行长度阈值，适配大文件夹的返回内容：

// 连接登录成功后、调用SelectMailBox/UIDSearchMailBox前设置即可
IdIMAP1->IOHandler->MaxLineLength = 64 * 1024 * 1024; // 设为64MB，可覆盖绝大多数大文件夹场景

• 规避兼容性问题：不要硬编码"SENT"作为已发送文件夹名称，不同邮件服务商的已发送文件夹命名规则差异极大，比如Gmail为[Gmail]/Sent Mail、Outlook为Sent Items、部分国内服务商为已发送，硬编码会在部分账号下出现选箱失败。正确做法是先调用ListMailBoxes()拉取全量文件夹列表，识别属性带lmsSent标记的文件夹，才是当前账号真实的已发送目录。
• 大文件夹优化：如果SENT文件夹邮件量超过10万封，不建议用skAll一次性拉全量UID，可按日期分段拉取，降低单次请求的返回数据量。

TIdIMAP原生支持服务端按日期筛选邮件，不需要拉取全量邮件到本地过滤，直接配置TIdIMAP4SearchRec的对应参数即可，常用日期类搜索键枚举值如下：

• skSince：匹配邮件内部日期晚于、等于指定日期的邮件
• skBefore：匹配邮件内部日期早于指定日期的邮件
• skOn：匹配邮件内部日期等于指定日期的邮件

筛选当日邮件的示例代码：

TIdIMAP4SearchRec sr[1];
sr[0].SearchKey = skSince;
sr[0].Date = TDateTime::CurrentDate(); // 传入当日0点时间，返回当日及之后的所有邮件
IdIMAP1->UIDSearchMailBox(EXISTINGARRAY(sr));

如果需要筛选固定日期区间（比如2024年5月整月的邮件），直接传多个搜索条件即可，多条件默认按AND逻辑组合：

TIdIMAP4SearchRec sr[2];
sr[0].SearchKey = skSince;
sr[0].Date = EncodeDate(2024,5,1);
sr[1].SearchKey = skBefore;
sr[1].Date = EncodeDate(2024,6,1);
IdIMAP1->UIDSearchMailBox(EXISTINGARRAY(sr));

上述筛选逻辑全部在IMAP服务端执行，不需要下载邮件内容，执行效率很高。除日期外，发件人、收件人、主题、已读状态等常见筛选维度都有对应的SearchKey枚举支持，文本类条件直接赋值给TIdIMAP4SearchRec.Text字段即可。

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