ASP.NET Core Minimal API多KYC文档上传至Azure存储技术问询

1. 文档上传实现及IFormFileCollection的使用 #

完全可以用IFormFileCollection处理多文件上传，这是ASP.NET Core处理客户端多文件上传的标准方案，具体实现步骤如下：

核心实现流程 #

1. 安装Azure存储SDK：通过NuGet安装Azure.Storage.Blobs官方包，这是操作Azure blob存储的核心依赖。
2. 注入Blob服务客户端：在Program.cs中配置并注入BlobServiceClient，用Azure存储连接字符串初始化：

   builder.Services.AddSingleton(_ => 
       new BlobServiceClient(builder.Configuration.GetConnectionString("AzureStorage")));
   

3. 封装上传服务：编写服务类处理blob上传逻辑，确保容器存在并处理文件流上传：

   public class KycDocumentService
   {
       private readonly BlobServiceClient _blobServiceClient;
       private const string KycContainer = "kyc-documents";
   
       public KycDocumentService(BlobServiceClient blobServiceClient)
       {
           _blobServiceClient = blobServiceClient;
           // 自动创建容器（如果不存在）
           _blobServiceClient.CreateBlobContainerIfNotExists(KycContainer, PublicAccessType.Blob);
       }
   
       public async Task<string> UploadSingleDocument(IFormFile file, string legalEntityId)
       {
           // 生成唯一Blob名称，避免重名冲突（用实体ID+UUID+原文件名）
           var blobName = $"{legalEntityId}/{Guid.NewGuid()}_{file.FileName}";
           var blobClient = _blobServiceClient.GetBlobContainerClient(KycContainer).GetBlobClient(blobName);
   
           // 上传文件流，同时设置ContentType（方便前端预览）
           using var stream = file.OpenReadStream();
           await blobClient.UploadAsync(stream, new BlobHttpHeaders { ContentType = file.ContentType });
   
           return blobClient.Uri.ToString();
       }
   }
   

4. 控制器接收多文件：在API控制器中通过IFormFileCollection接收多文件，批量调用上传服务：

   [ApiController]
   [Route("api/legal-entities/{entityId}/kyc")]
   public class KycController : ControllerBase
   {
       private readonly KycDocumentService _kycService;
   
       public KycController(KycDocumentService kycService)
       {
           _kycService = kycService;
       }
   
       [HttpPost("upload")]
       public async Task<IActionResult> BatchUpload(IFormFileCollection files, string entityId)
       {
           if (files.Count == 0)
               return BadRequest("未选择任何文件");
   
           var uploadedDocs = new List<string>();
           foreach (var file in files)
           {
               // 可添加文件大小、类型校验逻辑
               if (file.Length > 10 * 1024 * 1024)
                   return BadRequest($"文件 {file.FileName} 超过10MB限制");
   
               var docUrl = await _kycService.UploadSingleDocument(file, entityId);
               uploadedDocs.Add(docUrl);
           }
   
           return Ok(new { UploadedDocumentUrls = uploadedDocs });
       }
   }
   

2. 文档属性的完整性分析 #

你列出的DocumentType、DocumentName、DocumentDescription、DocumentUrl能满足基础业务记录需求，但从Azure存储管理和业务完整性角度，还需要补充几个关键属性：

建议补充的属性 #

• BlobName/BlobId：存储Azure blob的唯一标识（不是友好的DocumentName），因为DocumentUrl可能因存储账户配置变更失效，而BlobName是定位blob的核心依据，方便后续更新、删除操作。
• UploadedDateTime：记录文件上传时间，用于审计追踪和排序展示。
• FileSize：存储文件字节大小，方便统计和容量管理。
• ContentType：存储文件MIME类型（如application/pdf、image/jpeg），前端可直接据此实现文档预览，无需额外判断。
• LegalEntityId：关联对应的法人实体ID，这是KYC文档的核心归属字段，确保文档能准确绑定到目标实体。
• ETag：Azure blob返回的ETag值，用于并发控制（比如更新文档元数据时避免冲突）。

Azure存储的必填要求 #

Azure存储本身对blob元数据没有强制必填项，只要有BlobName（上传时指定的blob路径/名称）就能完成存储。但从业务系统的健壮性来看，上述补充属性是保证文档全生命周期管理的必要项。

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