萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 伺服器教學

Unity3D 連接 SQL Server 資料庫完整實戰教學

前置準備

  • Unity 版本:2017+ (支援 .NET 4.x / .NET Standard 2.0)
  • SQL Server 已啟用「SQL Server 和 Windows 驗證模式」 (混合模式)
  • 防火牆開放 1433 埠 (或自訂埠)

核心步驟:引用 System.Data.dll

Unity 專案預設不包含 ADO.NET 組件,需手動引用。

1. 尋找 System.Data.dll

路徑視 Unity 安裝位置而定,典型路徑:

C:\Program Files\Unity\Hub\Editor\<版本>\Editor\Data\Mono\lib\mono\unity\System.Data.dll
# 或舊版路徑
C:\Program Files\Unity\Editor\Data\Mono\lib\mono\unity\System.Data.dll
System.Data.dll 位置

2. 複製到專案 Assets 目錄

Assets/
└── Plugins/          # 建議放在 Plugins 資料夾確保優先載入
    └── System.Data.dll

3. Visual Studio 中添加引用 (若用 VS 編輯腳本)

專案右鍵 → 加入參考 → 瀏覽 → 選擇上述 System.Data.dll。

VS 加入參考
引用確認

4. 命名空間引用

using System;
using System.Data;
using System.Data.SqlClient;

連線與查詢核心代碼

public class SqlTest : MonoBehaviour
{
    private SqlConnection _conn;
    private SqlDataAdapter _adapter;

    void Start()
    {
        // 連線字串:必須使用 SQL Server 驗證 (sa/密碼),Windows 驗證在 Unity 中不支援
        string connStr = @"Server=127.0.0.1;Database=ConnectTest;User ID=sa;Password=123456;";
        
        _conn = new SqlConnection(connStr);
        try
        {
            _conn.Open();
            Debug.Log("資料庫連線成功!");

            string sql = "SELECT * FROM Table1";
            _adapter = new SqlDataAdapter(sql, _conn);
            DataSet ds = new DataSet();
            _adapter.Fill(ds, "Table1");

            if (ds.Tables["Table1"].Rows.Count > 0)
            {
                var firstCell = ds.Tables["Table1"].Rows[0][0];
                Debug.Log($"第一行第一欄值: {firstCell}");
            }
        }
        catch (Exception ex)
        {
            Debug.LogError($"資料庫操作失敗: {ex.Message}");
        }
    }

    void OnDestroy()
    {
        _adapter?.Dispose();
        _conn?.Close();
        _conn?.Dispose();
    }
}

執行結果驗證

Console 輸出成功

進階最佳實踐 (生產級)

議題建議方案
連線池連線字串加 Pooling=true;Min Pool Size=1;Max Pool Size=100; (預設開啟)
參數化查詢杜絕 SQL 注入:cmd.Parameters.AddWithValue("@id", id)
非同步操作使用 await _conn.OpenAsync(), await reader.ReadAsync() 避免卡主執行緒
連線字串管理存放於 Resources/connection.json 或 ScriptableObject,勿硬編碼
錯誤處理與重試Polly 套件實現指數退避重試
跨平台 (IL2CPP)確保 link.xml 保留 System.Data 命名空間,避免裁剪
替代方案考慮 Entity Framework Core (需 .NET Standard 2.0+)、Dapper (輕量 ORM)、或 REST API + HttpClient 解耦資料庫

常見錯誤與解決

總結

Unity 連接 SQL Server 核心在於 正確引用 System.Data.dll + 使用 SQL Server 驗證模式連線字串。生產環境請務必採用參數化查詢、非同步模式、連線池管理,並評估是否引入 EF Core/Dapper 或改用 API 層解耦,提升可維護性與安全性。

copyright © 萬盛學電腦網 all rights reserved
錯誤原因解決
TypeLoadException: System.Data.SqlClient缺少 System.Data.dll 或版本不匹配確認 DLL 放入 Plugins、Unity 版本對應 .NET 版本
Login failed for userSQL Server 未啟用混合驗證 / sa 密碼錯誤SSMS → 伺服器屬性 → 安全性 → SQL Server 和 Windows 驗證模式 → 重啟服務
Connection timeout防火牆、IP 錯誤、SQL Browser 服務未啟動 (命名實例)開放 1433/動態埠、啟用 SQL Browser、檢查連線字串 Server 名稱
IL2CPP 裁剪導致缺少型別Strip Level 高建立 Assets/link.xml 保留 System.Data, System.Data.SqlClient