ASP.NET MVC中通过Url Action传递byte[]数组参数时始终为null的解决方法

问题根源 #

你尝试通过Url.Action直接传递byte[]数组到控制器的做法不可行，核心原因有两点：

1. HTTP GET请求的URL存在长度限制，且默认模型绑定器无法解析URL中传递的byte[]类型参数——Url.Action会把byte[]直接转成字符串"System.Byte[]"，而非实际的字节数据。
2. 直接传递二进制数据到URL中会引发编码、长度超限等问题，控制器根本无法正确接收。

最优解决方案：传递文件标识而非byte[] #

最合理的做法是传递文件的唯一标识（比如数据库ID、服务器文件路径），让控制器根据标识去获取PDF的byte[]数据，避免直接传递二进制数据。

视图代码修改

@foreach (var item in Model.Files)
{
    <a href="@Url.Action("GetPDF", "Home", new { fileId = item.FileId })">Click Here</a>
}

这里假设你的File实体包含FileId属性，用于唯一标识该PDF文件。

控制器代码修改

public FileContentResult GetPDF(int fileId)
{
    // 根据fileId从数据库/服务器文件系统读取PDF的byte[]数据
    byte[] pdfBytes = RetrievePdfBytes(fileId);
    
    if (pdfBytes == null)
    {
        // 处理文件不存在的情况，比如返回404
        return new FileContentResult(new byte[0], "application/pdf");
    }
    
    return File(pdfBytes, "application/pdf");
}

// 示例：从数据库获取数据的方法
private byte[] RetrievePdfBytes(int fileId)
{
    // 替换为你的实际业务逻辑，比如从EF Core上下文查询
    using (var db = new YourDbContext())
    {
        return db.Files.FirstOrDefault(f => f.Id == fileId)?.FileData;
    }
}

特殊场景：必须传递byte[]的处理方式（不推荐大文件） #

如果因业务限制必须直接传递byte[]，可以将其转换为Base64编码字符串传递，再在控制器中解码回byte[]。但注意：Base64会让数据体积增大33%，大文件会触发URL长度限制（浏览器通常限制URL长度在2048字符左右）。

视图代码修改

@foreach (var item in Model.Files)
{
    string base64Pdf = Convert.ToBase64String(item.File);
    <a href="@Url.Action("GetPDF", "Home", new { base64Data = base64Pdf })">Click Here</a>
}

控制器代码修改

public FileContentResult GetPDF(string base64Data)
{
    if (string.IsNullOrWhiteSpace(base64Data))
    {
        return new FileContentResult(new byte[0], "application/pdf");
    }
    
    try
    {
        byte[] pdfBytes = Convert.FromBase64String(base64Data);
        return File(pdfBytes, "application/pdf");
    }
    catch (FormatException)
    {
        // 处理Base64解码失败的情况
        return new FileContentResult(new byte[0], "application/pdf");
    }
}

大文件场景：使用POST请求 #

如果是大文件，建议使用POST表单提交Base64编码后的字节数据：

视图代码修改

@foreach (var item in Model.Files)
{
    using (Html.BeginForm("GetPDF", "Home", FormMethod.Post, new { style = "display:inline;" }))
    {
        @Html.Hidden("base64Data", Convert.ToBase64String(item.File))
        <button type="submit" style="border:none; background:none; color:blue; text-decoration:underline; cursor:pointer;">Click Here</button>
    }
}

控制器代码修改

[HttpPost]
public FileContentResult GetPDF(string base64Data)
{
    if (string.IsNullOrWhiteSpace(base64Data))
    {
        return new FileContentResult(new byte[0], "application/pdf");
    }
    
    try
    {
        byte[] pdfBytes = Convert.FromBase64String(base64Data);
        return File(pdfBytes, "application/pdf");
    }
    catch (FormatException)
    {
        return new FileContentResult(new byte[0], "application/pdf");
    }
}

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