AD thumbnailPhoto属性字节格式影响因素及Exchange识别异常问题

字节头对应格式说明 #

首先明确两类字节头对应的标准文件格式：

• 以\FF\开头的字节流是JPEG/JPG格式的标准文件头（完整JPG头为\FF\D8\FF）
• 以\89\开头的字节流是PNG格式的标准文件头（完整PNG头为\89\50\4E\47\0D\0A\1A\0A）

影响属性字节格式的关键因素 #

• 上传程序的内置转码规则：这是导致当前问题的核心原因。自有应用上传图片时，无论源文件是什么格式，程序调用的图像编码接口默认会将图片转码为JPG格式后写入AD属性，因此无论更换什么源图，最终写入的字节都固定为\FF\开头；Exclaimer的上传逻辑默认会将图片转码为符合微软生态要求的PNG格式写入，因此字节头为\89\开头，可被Exchange、Teams正常识别。
• Exchange侧的格式校验规则：Exchange（含本地版和Exchange Online）对thumbnailPhoto属性有明确的准入要求，仅接受尺寸不超过96x96像素、文件大小不超过10KB的PNG格式文件，JPG格式内容写入后不会被Exchange同步拉取，因此无法在相关产品中展示。
• 字节流读取/写入的编码逻辑：如果程序在处理图片时未按原始二进制流读写，而是额外做了字符集转码、Base64编解码错误处理，也会导致写入的字节格式异常，但当前场景固定输出JPG格式头，不属于这类编码错误。

修复方案 #

• 修改自有应用的图片处理逻辑，将待写入AD的图片统一转码为PNG格式，读取原始二进制字节流后写入thumbnailPhoto属性
• 写入前增加前置校验：确保最终写入的图片尺寸≤96*96px，文件大小≤10KB，字节头匹配PNG标准格式
• 不要依赖用户上传的源文件格式做判断，必须在服务端完成统一转码后再执行写入操作，避免源文件格式差异导致的写入异常

字节内容对比参考 #

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