ASP.NET Core 2.0文件上传下载问题求助：迁移代码遇存储及下载障碍

嗨，我来帮你搞定这两个迁移时遇到的棘手问题！咱们一个个来解决：

一、解决SQL Server存储文档变成0字节的问题 #

出现0字节的核心原因通常是文件流读取不完整或者流位置错误。在ASP.NET Core中处理上传文件时，我们需要正确读取IFormFile的内容，确保拿到完整的字节数组再存入数据库。

正确的存储代码示例（ADO.NET方式） #

public async Task<IActionResult> Upload(IFormFile file)
{
    if (file == null || file.Length == 0)
        return BadRequest("请选择要上传的文件");

    // 将文件流转换为字节数组
    using (var memoryStream = new MemoryStream())
    {
        await file.CopyToAsync(memoryStream);
        var fileBytes = memoryStream.ToArray(); // CopyToAsync完成后，ToArray会自动处理流位置，无需手动重置

        // 存入SQL Server
        using (var conn = new SqlConnection("你的数据库连接字符串"))
        {
            await conn.OpenAsync();
            var cmd = new SqlCommand(
                "INSERT INTO Documents (FileContent, FileName, ContentType) VALUES (@Content, @FileName, @ContentType)", 
                conn);
            
            // 使用参数化查询，避免SQL注入，同时确保字节数组正确传递
            cmd.Parameters.Add("@Content", SqlDbType.VarBinary, fileBytes.Length).Value = fileBytes;
            cmd.Parameters.Add("@FileName", SqlDbType.NVarChar, 255).Value = file.FileName;
            cmd.Parameters.Add("@ContentType", SqlDbType.NVarChar, 100).Value = file.ContentType;

            await cmd.ExecuteNonQueryAsync();
        }
    }

    return Ok("文件上传成功");
}

常见错误点排查 #

• 不要直接读取file.OpenReadStream()后就转换为字节数组，因为流的初始位置可能在末尾，导致读取到空数据；
• 务必使用异步方法（如CopyToAsync）处理流操作，避免阻塞线程；
• 确保数据库中存储文件的字段类型是VARBINARY(MAX)，避免长度限制导致截断。

如果使用EF Core，代码会更简洁：

// 假设你的实体类定义如下
public class Document
{
    public int Id { get; set; }
    public byte[] FileContent { get; set; }
    public string FileName { get; set; }
    public string ContentType { get; set; }
}

// 上传Action中的EF Core存储逻辑
public async Task<IActionResult> Upload(IFormFile file, YourDbContext dbContext)
{
    if (file == null || file.Length == 0)
        return BadRequest("请选择要上传的文件");

    using (var memoryStream = new MemoryStream())
    {
        await file.CopyToAsync(memoryStream);
        var document = new Document
        {
            FileContent = memoryStream.ToArray(),
            FileName = file.FileName,
            ContentType = file.ContentType
        };

        dbContext.Documents.Add(document);
        await dbContext.SaveChangesAsync();
    }

    return Ok("文件上传成功");
}

二、替代Response.BinaryWrite()实现文件下载 #

ASP.NET Core中确实移除了Response.BinaryWrite()，我们可以用**FileResult系列方法**来替代，这是Core中推荐的文件返回方式，更简洁且符合框架设计。

下载功能代码示例 #

public async Task<IActionResult> Download(int documentId, YourDbContext dbContext)
{
    // 从数据库查询文件信息
    var document = await dbContext.Documents.FindAsync(documentId);
    if (document == null)
        return NotFound("文件不存在");

    // 设置下载头，强制浏览器下载而非在线打开
    var contentDisposition = new System.Net.Mime.ContentDisposition
    {
        FileName = document.FileName,
        Inline = false // false表示下载，true表示在浏览器中打开
    };
    Response.Headers.Add("Content-Disposition", contentDisposition.ToString());

    // 返回FileContentResult，替代BinaryWrite
    return File(document.FileContent, document.ContentType);
}

关键说明 #

• File()方法支持三种返回形式：字节数组、流、物理文件路径，这里我们用字节数组直接返回；
• 通过Content-Disposition头可以控制文件的下载行为，Inline=false确保浏览器触发下载弹窗；
• 如果文件较大，建议使用FileStreamResult（返回流），避免一次性加载大量字节到内存中，示例如下：

public async Task<IActionResult> DownloadLargeFile(int documentId)
{
    string fileName = "";
    string contentType = "";

    // 从数据库读取流（假设用ADO.NET直接获取流）
    using (var conn = new SqlConnection("你的连接字符串"))
    {
        await conn.OpenAsync();
        var cmd = new SqlCommand("SELECT FileContent, FileName, ContentType FROM Documents WHERE Id = @Id", conn);
        cmd.Parameters.Add("@Id", SqlDbType.Int).Value = documentId;
        
        var stream = await cmd.ExecuteReaderAsync(CommandBehavior.SequentialAccess);
        if (await stream.ReadAsync())
        {
            fileName = stream["FileName"].ToString();
            contentType = stream["ContentType"].ToString();
            var fileStream = stream.GetStream(0); // 获取字段对应的流
            Response.Headers.Add("Content-Disposition", $"attachment; filename=\"{fileName}\"");
            return File(fileStream, contentType);
        }
        else
        {
            return NotFound();
        }
    }
}

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