通过Web API向SQL数据库上传大图片时对象为空问题排查

开发者阿泽

2026-5-28

问题分析：Web API无法接收6MB图片提交，对象显示为null

我来帮你捋清楚这个问题——你遇到的情况和数据库存储容量完全无关（毕竟6MB远小于byte[]的2GB上限，手动插入也能成功），问题大概率出在Web API的默认请求大小限制上，结合base64编码的额外开销，直接触发了请求截断，导致后端接收不到完整的对象，所以显示为null。

核心原因拆解

base64的体积膨胀效应
你把图片转成base64字符串时，原始6MB的二进制数据会膨胀约33%，最终变成8MB左右的字符串。而从你的代码里的System.Configuration判断，你用的是ASP.NET Framework，它的默认请求大小限制是4MB，这个8MB的请求直接超过了阈值，Web服务器会直接截断请求，后端自然拿不到完整的对象，只能得到null。
双重限制的叠加
除了ASP.NET的maxRequestLength限制，IIS还有一个maxAllowedContentLength的请求过滤限制（默认约28.6MB，你的情况暂时没触发，但后续更大文件还是会有隐患），不过当前的核心问题是前者的4MB上限。

具体解决步骤

1. 修改Web.config，提升请求大小上限

打开你的Web API项目的Web.config，做两处修改：

在<system.web>节点下，设置maxRequestLength（单位是KB，这里设为20480对应20MB，足够覆盖你的场景）：

<system.web>
  <httpRuntime targetFramework="你的.NET版本号" maxRequestLength="20480" />
</system.web>

在<system.webServer>节点下的requestFiltering中，设置maxAllowedContentLength（单位是字节，20MB对应20971520）：

<system.webServer>
  <security>
    <requestFiltering>
      <requestLimits maxAllowedContentLength="20971520" />
    </requestFiltering>
  </security>
</system.webServer>

2. 检查控制器的额外限制

如果你的Web API控制器方法上有类似[RequestSizeLimit]的属性（ASP.NET Core常见，Framework也可能有自定义限制），确保它的数值足够大。另外，确认前端提交时的Content-Type是application/json，并且序列化base64字符串时没有截断。

3. （推荐）优化传输方式，避免base64开销

其实转base64完全是多此一举，直接用multipart/form-data上传二进制文件更高效：

前端用FormData封装图片文件，直接提交；
后端用HttpPostedFileBase接收文件，再转成byte[]存入数据库，这样既省了33%的传输体积，也能避免字符串序列化的潜在问题。

你的代码里的小细节提醒

看你的SaveTicketPhoto方法，DataTable行添加时写了tcktPhoto.PhotoData，但你的TicketPhoto类里只有Description属性，这里明显是笔误，应该改成tcktPhoto.Description，不然存储时Description字段会出错：

ticketPhotoTable.Rows.Add(
    tcktPhoto.PhotoID,
    tcktPhoto.Photo,
    tcktPhoto.Description // 修正这里的笔误
);

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