ASP.NET 圖片存儲最佳實踐：資料庫與檔案系統混合架構

前言：圖片存儲的兩難選擇

在 Web 應用開發中，圖片等二進位大物件（BLOB）的存儲方式向來是架構設計的關鍵決策點。單純存資料庫易導致 I/O 瓶頸與備份膨脹；單純存檔案系統則面臨資料一致性、備份同步、權限管理等挑戰。本文提出「資料庫存元數據、檔案系統存實體」的混合架構，並在 ASP.NET + SQL Server 環境下給出完整落地方案。

一、兩種主流存儲模式深度對比

決策建議

• 小檔案（< 256 KB）、高一致性要求：優先考慮資料庫內建 FILESTREAM（SQL 2008+）或 varbinary(max)
• 大檔案、高併發讀取、需 CDN 分發：採用混合架構，實體檔案落地磁碟/物件存儲

二、混合架構實作藍圖

1. 資料表設計

CREATE TABLE dbo.MyImages (
    ImageID       INT IDENTITY(1,1) PRIMARY KEY,
    RelativePath  NVARCHAR(500) NOT NULL,   -- 相對路徑：/uploads/2024/01/abc.jpg
    FileName      NVARCHAR(255) NOT NULL,
    ContentType   NVARCHAR(100) NOT NULL,   -- image/jpeg, image/png
    FileSize      BIGINT NOT NULL,
    Description   NVARCHAR(MAX) NULL,
    UploadUserID  INT NOT NULL,
    UploadTime    DATETIME2(3) NOT NULL DEFAULT SYSUTCDATETIME(),
    IsActive      BIT NOT NULL DEFAULT 1,
    CONSTRAINT UQ_Path UNIQUE (RelativePath)
);
CREATE INDEX IX_MyImages_UserTime ON dbo.MyImages (UploadUserID, UploadTime DESC);

2. 檔案落地策略

• 目錄分層：/uploads/{yyyy}/{MM}/{dd}/{Guid}.{ext} 避免單目錄檔案過多
• 命名規則：Guid + 原始副檔名，杜絕重名與特殊字元風險
• 權限隔離：上傳目錄僅授予應用程式池身分寫入權限，公開讀取由 IIS 靜態處理

3. ASP.NET 核心上傳程式碼

[HttpPost]
public async Task<ActionResult> Upload(HttpPostedFileBase file, string description)
{
    if (file == null || file.ContentLength == 0) return Json(new { success = false, msg = "空檔案" });

    // 1. 驗證副檔名與 Content-Type
    var allowed = new[] { ".jpg", ".jpeg", ".png", ".gif", ".webp" };
    var ext = Path.GetExtension(file.FileName).ToLowerInvariant();
    if (!allowed.Contains(ext)) return Json(new { success = false, msg = "不支援的格式" });

    // 2. 產生儲存路徑
    var dateDir = DateTime.UtcNow.ToString("yyyy/MM/dd");
    var saveDir = Server.MapPath($"~/uploads/{dateDir}");
    Directory.CreateDirectory(saveDir);
    var newName = $"{Guid.NewGuid():N}{ext}";
    var fullPath = Path.Combine(saveDir, newName);
    var relPath = $"/uploads/{dateDir}/{newName}";

    // 3. 串流存檔（避免大檔案佔用記憶體）
    using (var fs = new FileStream(fullPath, FileMode.CreateNew, FileAccess.Write, FileShare.None, 81920, true))
    {
        await file.InputStream.CopyToAsync(fs);
    }

    // 4. 寫入資料庫（交易包裹）
    using (var conn = new SqlConnection(connStr))
    using (var cmd = new SqlCommand(@"
        INSERT INTO dbo.MyImages (RelativePath, FileName, ContentType, FileSize, Description, UploadUserID)
        VALUES (@path, @name, @type, @size, @desc, @uid);", conn))
    {
        cmd.Parameters.AddWithValue("@path", relPath);
        cmd.Parameters.AddWithValue("@name", file.FileName);
        cmd.Parameters.AddWithValue("@type", file.ContentType);
        cmd.Parameters.AddWithValue("@size", file.ContentLength);
        cmd.Parameters.AddWithValue("@desc", description ?? "");
        cmd.Parameters.AddWithValue("@uid", CurrentUser.Id);
        await conn.OpenAsync();
        await cmd.ExecuteNonQueryAsync();
    }

    return Json(new { success = true, path = relPath });
}

4. 圖片讀取與刪除策略

• 讀取：前端直接 ``，IIS 靜態模組處理，零 .NET 執行緒佔用
• 軟刪除：`IsActive = 0`，定期離線作業掃描軟刪除超 30 天記錄並物理刪除檔案
• 硬刪除：交易中先 `DELETE` 資料列再 `File.Delete()`，捕獲例外時回寫資料庫標記異常供人工介入

三、進階優化：從本地磁碟到雲端物件存儲

隨著系統擴展，本地磁碟面臨單點、擴容、跨機房同步難題。建議引入介面抽象：

public interface IBlobStore {
    Task<string> SaveAsync(Stream content, string contentType, CancellationToken ct);
    Task DeleteAsync(string key, CancellationToken ct);
    string GetPublicUrl(string key);
}

// 實作：LocalBlobStore / AzureBlobStore / S3BlobStore / MinIOBlobStore

資料表 `RelativePath` 改為 `BlobKey`，上層業務邏輯完全不變，無縫遷移至 Azure Blob Storage、AWS S3 或自建 MinIO。

四、常見坑點與對策

五、總結

「資料庫存元數據、檔案系統存實體」混合架構兼顧了效能、擴展性與維運便利性。關鍵在於：

1. 嚴格的檔案命名與目錄分層規範
2. 資料庫與檔案操作的原子性保障（交易 + 補償）
3. 介面抽象預留雲端遷移彈性
4. 安全性防護貫穿上傳、存儲、訪問全鏈路

採用此模式，可支撐從中小型專案到千萬級用戶的圖片業務平滑演進。