.NET Core 3.1 API文件返回编码问题求助：ReadAsStringAsync异常

• 核心问题：你错误地使用ReadAsStringAsync()读取二进制文件内容。DOCX、DOC、PDF、RTF都是二进制格式（哪怕RTF看起来像文本，实际是带特定结构的二进制流），强行将其转为UTF-8字符串会破坏原始字节结构，导致特殊字符（连字符、点号等）乱码。

具体修复步骤 #

1. 替换内容读取方式 #

把客户端的字符串读取代码，改为直接读取字节数组：

// 替换原来的ReadAsStringAsync()
byte[] fileBytes = response.Content.ReadAsByteArrayAsync().Result;
// 直接保存字节到文件，避免编码转换
File.WriteAllBytes("output.docx", fileBytes);

2. API端确保返回正确的响应格式 #

你的API在生成文件后，必须返回原始字节流，并设置对应Content-Type，不要将二进制转为字符串返回。示例代码：

[HttpGet("generate-document")]
public IActionResult GenerateDocument(string content, string format)
{
    byte[] fileBytes;
    string contentType;
    string fileName;

    // 根据format生成对应文件的字节数组（替换成你的生成逻辑）
    switch(format.ToLower())
    {
        case "docx":
            fileBytes = GenerateDocx(content);
            contentType = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
            fileName = "output.docx";
            break;
        case "pdf":
            fileBytes = GeneratePdf(content);
            contentType = "application/pdf";
            fileName = "output.pdf";
            break;
        // 其他格式同理
        default:
            return BadRequest("Unsupported format");
    }

    // 返回原始字节流，自动处理正确的编码和头
    return File(fileBytes, contentType, fileName);
}

3. 验证客户端调用 #

用curl调用时，直接保存响应到文件，不要转文本：

curl -o output.docx "https://your-api-url/generate-document?content=test&format=docx"

额外注意事项 #

• 如果你是从字符串生成这些文件（比如生成RTF），确保生成工具使用正确的编码写入（比如UTF-8带BOM，或者对应格式要求的编码），但核心是不要在API或客户端将二进制转为字符串。
• 避免使用Result同步调用异步方法，建议用await：

byte[] fileBytes = await response.Content.ReadAsByteArrayAsync();

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