.NET Framework 4.7.1中CSV下载丢失换行问题求助

可能的原因与解决方案 #

1. 修正Content-Type并指定编码 #

直接返回文件路径时，默认的text/csv类型未明确指定编码，可能导致客户端解析时错误处理换行符。修改为带UTF-8编码的Content-Type：

public async Task<FileResult> Download()
{
    string filepath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "filename.csv");
    if (!System.IO.File.Exists(filepath))
        System.IO.File.WriteAllText(filepath, "", Encoding.UTF8);

    // 明确指定编码的Content-Type
    return File(filepath, "text/csv; charset=utf-8", "filename.csv");
}

2. 使用文件流返回，避免自动处理 #

直接返回文件路径可能被框架或服务器自动修改内容，改用FileStream读取文件并返回，确保原始内容不被篡改：

public async Task<FileResult> Download()
{
    string filepath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "filename.csv");
    if (!System.IO.File.Exists(filepath))
        System.IO.File.WriteAllText(filepath, "", Encoding.UTF8);

    var stream = new FileStream(filepath, FileMode.Open, FileAccess.Read, FileShare.Read, 4096, useAsync: true);
    return File(stream, "text/csv; charset=utf-8", "filename.csv");
}

3. 手动构建FileContentResult并设置响应头 #

如果上述方法无效，手动构建文件内容结果，强制设置响应头确保客户端正确解析：

public async Task<ActionResult> Download()
{
    string filepath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "filename.csv");
    if (!System.IO.File.Exists(filepath))
        System.IO.File.WriteAllText(filepath, "", Encoding.UTF8);

    byte[] fileBytes = System.IO.File.ReadAllBytes(filepath);
    var result = new FileContentResult(fileBytes, "text/csv; charset=utf-8")
    {
        FileDownloadName = "filename.csv"
    };
    // 显式设置Content-Disposition头
    result.Response.Headers.Add("Content-Disposition", "attachment; filename=\"filename.csv\"");
    return result;
}

4. 确保CSV文件使用Windows换行符(CRLF) #

确认生成文件时使用\r\n作为换行符，推荐用File.WriteAllLines方法写入，它会自动使用系统默认换行符（Windows下为CRLF）：

// 示例：生成CSV内容时用WriteAllLines
var csvLines = new List<string>
{
    "列1,列2,列3",
    "值1,值2,值3",
    "值4,值5,值6"
};
System.IO.File.WriteAllLines(filepath, csvLines, Encoding.UTF8);

5. 检查服务器(IIS)设置 #

如果以上代码都无效，检查IIS是否启用了HTTP响应压缩中的静态压缩功能，部分情况下压缩可能导致换行符丢失。可以临时关闭静态压缩测试，或在web.config中添加配置排除CSV文件的压缩：

<system.webServer>
    <urlCompression doStaticCompression="false" />
    <!-- 或仅排除CSV -->
    <staticContent>
        <remove fileExtension=".csv" />
        <mimeMap fileExtension=".csv" mimeType="text/csv" />
    </staticContent>
</system.webServer>

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