MyBatis 搭配 SQL Server JDBC 連線字串優化效能實戰

問題背景

在使用 MyBatis 操作 SQL Server 資料庫時，執行簡單的更新語句卻發現效能極差。經監控發現，JDBC 驅動程式產生的參數型別為 nvarchar(4000)，導致查詢計畫無法有效使用索引，造成全表掃描。

問題重現

原始 Mapper 設定

<update id="updateDriverInfoByUcode" parameterType="com.sypro.earth.model.DriverInfo">
  update D_DriverInfo
  <set>
    <if test="driverName != null">
      DriverName = #{driverName,jdbcType=NVARCHAR},
    </if>
  </set>
  <where>
    Ucode=#{ucode,javaType=string,jdbcType=VARCHAR,typeHandler=com.sypro.earth.typehandler.ExampleTypeHandler}
  </where>
</update>

產生的 SQL 與參數

(@P0 nvarchar(4000),@P1 nvarchar(4000))
update D_DriverInfo SET DriverName = @P0 WHERE Ucode=@P1

根本原因分析

SQL Server JDBC 驅動程式預設將字串參數視為 Unicode (nvarchar)，而資料表欄位若為非 Unicode 型別 (varchar)，會導致隱含型別轉換，使索引失效，查詢效能大幅下降。

解決方案：調整 JDBC 連線字串

在連線字串中加入 sendStringParametersAsUnicode=false 參數，強制驅動程式以非 Unicode 型別傳送字串參數。

修改前

jdbc:sqlserver://127.0.0.1;databaseName=new;

修改後

jdbc:sqlserver://127.0.0.1;databaseName=new;sendStringParametersAsUnicode=false

優化效果驗證

調整後，監控到的參數型別變為 varchar(8000)，查詢計畫正常使用索引，批量更新效能顯著提升。

參考資源

• Microsoft 官方文件：使用 sendStringParametersAsUnicode 屬性
• Microsoft 官方文件：資料型別對應

結語

面對 ORM 框架效能問題時，別忘了檢查底層 JDBC 驅動程式的行為。一個小小的連線字串參數，有時能帶來數量級的效能提升。