IBM XMS .Net 接收MQ中PNG、ZIP等二进制文件损坏如何解决？

问题根本原因 #

二进制文件（png、zip等非纯文本格式）被错误当成ITextMessage处理是文件损坏的核心原因：ITextMessage的本质是按照字符编码规则解析内容，二进制数据中存在大量不符合UTF-8编码规范的字节，会被自动替换为�（也就是你看到的?字符），这个替换过程是不可逆的，原始数据已经丢失，哪怕再转回字节也无法恢复原始文件。

需要修正的处理逻辑 #

1. 消息类型判断优先级调整 #

你现有代码中IBytesMessage的判断使用了else if，说明前面还存在其他判断逻辑，大概率是二进制消息被提前拦截，没有走到字节消息的处理分支，先调整判断顺序，优先处理字节消息：

var fileName = "test.png";
// 优先判断字节消息，二进制类内容统一走该分支
if (message is IBytesMessage)
{
    IBytesMessage bytesMessage = (IBytesMessage)message;
    var messageLength = bytesMessage.ReadInt();
    byte[] uploadPayload = new byte[messageLength];
    bytesMessage.ReadBytes(uploadPayload, messageLength);

    var filePath = _fileUtil.SaveBytesFile(fileName, uploadPayload);
    return filePath;
}
// 文本消息仅用于处理纯文本类内容（如txt、json等）
else if (message is ITextMessage)
{
    var msg = (ITextMessage)message;
    var result = msg.Text;
    var plainTextBytes = Encoding.UTF8.GetBytes(result);
    var filePath = _fileUtil.SaveBytesFile(fileName, plainTextBytes);
    return filePath;
}

2. 发送端逻辑校验 #

要保证发送端的消息类型约定和接收端一致：

• 所有非纯文本的二进制文件，发送时必须显式封装为IBytesMessage，绝对不要把二进制字节直接转成字符串塞进ITextMessage，任何字符编码的转码操作都会破坏二进制数据。
• 可选优化：可以在消息的自定义头中加入ContentType字段，标记文件的MIME类型（如image/png、application/zip），接收端可以通过该字段更精准地选择处理逻辑，比仅依靠消息类型判断更可靠。

特殊场景兼容 #

如果发送端逻辑无法修改，确实是将二进制文件做了Base64编码后塞进ITextMessage传输，那接收端需要先对msg.Text做Base64解码，再保存为文件，不要直接用UTF8转字节：

// 仅适用于发送端做了Base64编码的场景
var fileBytes = Convert.FromBase64String(msg.Text);
var filePath = _fileUtil.SaveBytesFile(fileName, fileBytes);

如果发送端没有做Base64编码，直接把二进制内容塞进了ITextMessage，那么传输链路本身就存在数据丢失的问题，必须修改发送端逻辑才能解决。

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