ASP.NET aspnet_regsql.exe 註冊資料庫常見錯誤排查：無法查詢資料庫清單、sysdatabases 無效、權限問題完整解決方案

錯誤場景重現

使用 `aspnet_regsql.exe` 精靈時，選擇伺服器、輸入 SQL 驗證帳號密碼後，點選資料庫下拉清單，出現：

錯誤 1：`未能查詢 SQL Server 中的資料庫名稱清單。無法開啟使用者預設資料庫，登入失敗，使用者 'testdb' 登入失敗。`

錯誤 2 (授予 sysadmin 後)：`未能查詢 SQL Server 中的資料庫名稱清單。物件名稱 'sysdatabases' 無效。`

根本原因分析

錯誤 1：預設資料庫設定錯誤 / 登入失敗

• SQL 登入 `testdb` 的 **預設資料庫** 設為 `TESTDB`，但該資料庫可能不存在、離線、或帳號無權限。
• 精靈連線時未指定 `Initial Catalog`，SQL Server 嘗試開啟預設資料庫 → 失敗 → 登入失敗 → 無法查詢 `sys.databases`。

錯誤 2：工具相容性 / 權限視圖問題

• `aspnet_regsql.exe` (v2.0 版本) 內部查詢資料庫清單可能使用舊系統表 `sysdatabases` (SQL 2000) 而非 `sys.databases` (SQL 2005+)。
• 即使帳號是 `sysadmin`，某些情況下 (如含有資料庫快照、鏡像、AlwaysOn) 查詢系統目錄會受阻。
• 工具本身的 Bug：不支援新版 SQL Server 目錄檢視，或連線字串組裝邏輯有缺陷。

解決方案 (按推薦順序)

方案一：手動輸入資料庫名稱 (最快繞過法) ✅

**現象**：下拉清單無法展開，但**輸入框可編輯**。

**操作**：直接在資料庫下拉框輸入目標資料庫名稱 (如 `TESTDB`)，按 `Tab` 或點擊 `下一步`。

**結果**：精靈跳過查詢清單步驟，直接嘗試連線指定資料庫執行建立腳本，**多數情況下即可成功**。

⚠ 前提：資料庫 `TESTDB` 必須已存在，且登入帳號擁有該資料庫的 `db_owner` 權限 (或 `db_ddladmin` + `db_datareader` + `db_datawriter`)。

方案二：修正 SQL 登入預設資料庫

-- SSMS 執行
ALTER LOGIN [testdb] WITH DEFAULT_DATABASE = [master];
GO
-- 或透過 SSMS 介面：安全性 → 登入 → testdb → 屬性 → 常規 → 預設資料庫 → master

將預設資料庫改為 `master` (永遠存在)，避免登入階段失敗。

方案三：授予足夠權限 (最小權限原則)

**不需 `sysadmin`**，僅需：

1. 伺服器層級：`VIEW ANY DATABASE` (查詢清單用) 或 `dbcreator` (建立新資料庫用)。
2. 目標資料庫層級：`db_owner` (建立表/SP/檢視需完整 DDL/DML 權限)。

-- 建立登入並授權
CREATE LOGIN [app_reg] WITH PASSWORD = 'StrongP@ssw0rd', DEFAULT_DATABASE = [master];
GRANT VIEW ANY DATABASE TO [app_reg]; -- 允許查詢清單

USE [TESTDB];
CREATE USER [app_reg] FOR LOGIN [app_reg];
ALTER ROLE [db_owner] ADD MEMBER [app_reg];

方案四：使用較新版本工具 (v4.0 目錄)

C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regsql.exe
-- 或 64 位元版
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regsql.exe

.NET 4.0 版工具修正了對 `sys.databases` 的查詢相容性，支援 SQL 2008/2012/2014/2016/2019。

方案五：匯出 SQL 腳本由 DBA 執行 (最穩健)

aspnet_regsql.exe -S . -U app_reg -P 'StrongP@ssw0rd' -A all -d TESTDB -sqlexportonly > Install_AspNet_Services.sql

• 產生純 SQL 腳本，交由 DBA 在 SSMS 執行，避開工具連線/權限/相容性問題。
• 腳本可納入版本控管，部署流程標準化。

方案六：驗證資料庫狀態

-- 確認資料庫線上、非單用戶、非緊急模式
SELECT name, state_desc, user_access_desc FROM sys.databases WHERE name = 'TESTDB';
-- state_desc 必須為 ONLINE
-- user_access_desc 必須為 MULTI_USER

驗證註冊成功的標準流程

1. 開啟 SSMS → 展開 `TESTDB` → 資料表 → 確認存在 11 張 `aspnet_*` 開頭資料表。
2. Visual Studio → 專案 → **ASP.NET 組態** → 安全性 → **選取驗證類型** → **從網際網路** → 完成。
3. 點選 **測試** 連結 → 顯示「資料庫連接成功」。
4. 

若測試失敗：檢查 IIS LocalSqlServer 連線字串

ASP.NET 組態工具預設讀取 `machine.config` 中的 `LocalSqlServer` (指向 `.\SQLEXPRESS` 的 `aspnetdb`)。需覆寫：

1. IIS 管理員 → 網站 → 您的應用程式 → **連線字串** (雙擊)。
2. 編輯 `LocalSqlServer`：`Server=.;Database=TESTDB;User Id=app_reg;Password=*****;`
3. 或在專案 `web.config` 覆寫 (見上篇文章)。

總結：標準排查清單

核心心法：**工具查詢清單易失敗，手動輸入資料庫名稱是通用繞過法；權限給足、預設庫設對、版本用新、腳本落地**。