ASP.NET Core LocalDB 連接字串在其他電腦失效：AttachDbFilename 與實例名解析

問題現象

開發機運行正常，複製到教師電腦報錯：找不到 LocalDB 實例名。連接字串：

"Data Source=(LocalDB)\\MSSQLLocalDB;AttachDbFilename=|DataDirectory|\\Database.mdf;Integrated Security=True;Connect Timeout=30"

根因分析

1. LocalDB 未安裝：教師電腦未安裝 SQL Server Express LocalDB (獨立安裝包 ~30MB)。
2. 實例名不存在：(LocalDB)\\MSSQLLocalDB 是**自動實例**名，需 LocalDB 服務運行且實例已創建。
3. |DataDirectory| 解析路徑差異：ASP.NET Core 中 |DataDirectory| 默認指向 ContentRootPath/App_Data，需確保 .mdf 文件隨部署複製到該目錄。
4. 文件鎖定/權限：.mdf/.ldf 文件需寫入權限，且不被其他進程佔用。

解決方案對比

方案 A：保留 LocalDB (需教師電腦安裝)

1. 教師電腦安裝 SQL Server 2019 Express LocalDB。
2. 命令行創建/啟動實例：
   sqllocaldb create MSSQLLocalDB
sqllocaldb start MSSQLLocalDB
3. 確保連接字串中 AttachDbFilename 指向絕對路徑或正確相對路徑。

方案 B：改用 SQLite (零配置、單文件、跨平台) — 推薦教學/演示場景

"Data Source=|DataDirectory|\\Database.db;Cache=Shared"

• NuGet 安裝 Microsoft.Data.Sqlite / Microsoft.EntityFrameworkCore.Sqlite。
• 單 .db 文件隨項目複製，無需安裝任何服務。
• EF Core 代碼幾乎無需修改 (僅 Provider 不同)。

方案 C：使用完整 SQL Server Express / Developer Edition

• 安裝完整實例，連接字串改為 Data Source=.;Initial Catalog=MyDb;Integrated Security=True。
• 需手動附加/還原數據庫，適合長期項目不適合一次性演示。

連接字串關鍵參數說明

調試技巧

// 程式碼中輸出實際解析路徑
var connStr = Configuration.GetConnectionString("Default");
var builder = new SqlConnectionStringBuilder(connStr);
var mdfPath = builder.AttachDbFilename;
var resolved = mdfPath.Replace("|DataDirectory|", 
    AppDomain.CurrentDomain.GetData("DataDirectory").ToString());
Console.WriteLine("實際 MDF 路徑: " + resolved);

總結建議

教學作業交付，**強烈建議改用 SQLite**，消除環境依賴，教師雙擊即可運行。若必須用 LocalDB，請附帶 安裝指引文檔 與 啟動實例腳本。