如何在WIX Installer UI中提前测试MariaDB连接凭据？

我之前刚好做过类似的需求，核心思路是把MariaDB兼容的数据库连接器嵌入到安装包中，通过WIX的自定义动作执行连接测试，完全不需要用户提前安装任何驱动。下面是具体的实现方案和细节：

核心方案：嵌入MySqlConnector（兼容MariaDB）做自定义动作测试 #

MariaDB和MySQL的协议基本兼容，我们可以用纯.NET的MySqlConnector库（它比官方的MySQL Connector/NET更轻量，且完美支持MariaDB），把它打包到安装包里，彻底摆脱对系统已安装驱动的依赖。

步骤分解 #

1. 准备自定义动作项目

   • 在你的WIX解决方案里新建一个C#类库项目（推荐用.NET Framework 4.8，和WIX兼容性最好）
   • 通过NuGet安装MySqlConnector包，这个包是纯托管代码，没有原生依赖，非常适合嵌入

2. 编写连接测试代码
   写一个自定义动作方法，读取WIX UI中用户输入的数据库凭据，创建连接并测试：

   using Microsoft.Deployment.WindowsInstaller;
   using MySqlConnector;
   
   namespace WixCustomActions
   {
       public class DbActions
       {
           [CustomAction]
           public static ActionResult TestMariaDbConnection(Session session)
           {
               session.Log("Starting MariaDB connection test...");
               
               // 从WIX会话中获取用户输入的参数（这些参数需要在UI对话框中提前定义）
               var server = session["DB_SERVER"] ?? "localhost";
               var port = session["DB_PORT"] ?? "3306";
               var username = session["DB_USER"];
               var password = session["DB_PASSWORD"];
               var database = session["DB_DATABASE"];
   
               if (string.IsNullOrEmpty(username) || string.IsNullOrEmpty(password))
               {
                   session["CONN_ERROR_MSG"] = "请输入用户名和密码";
                   return ActionResult.Failure;
               }
   
               // 构建连接字符串，添加超时避免用户等待过久
               var connString = $"server={server};port={port};user id={username};password={password};database={database};Connection Timeout=5";
   
               try
               {
                   using var conn = new MySqlConnection(connString);
                   conn.Open(); // 尝试打开连接
                   session.Log("Connection test succeeded!");
                   session["CONN_SUCCESS"] = "1";
                   return ActionResult.Success;
               }
               catch (MySqlException ex)
               {
                   // 根据错误码给出更友好的提示
                   string errorMsg = ex.Number switch
                   {
                       1045 => "用户名或密码错误",
                       1042 => "无法连接到数据库服务器，请检查地址和端口",
                       1049 => "指定的数据库不存在",
                       _ => $"连接失败：{ex.Message}"
                   };
                   session.Log($"Connection failed: {ex.Message} (Code: {ex.Number})");
                   session["CONN_ERROR_MSG"] = errorMsg;
                   return ActionResult.Failure;
               }
               catch (Exception ex)
               {
                   session.Log($"Unexpected error: {ex.Message}");
                   session["CONN_ERROR_MSG"] = "发生未知错误，请检查网络或配置";
                   return ActionResult.Failure;
               }
           }
       }
   }
   

3. 打包自定义动作和连接器

   • 确保MySqlConnector.dll被复制到自定义动作项目的输出目录（在NuGet包属性里设置“复制到输出目录”为“始终复制”）
   • 在WIX项目中，把自定义动作的dll和MySqlConnector.dll都作为Binary元素添加：

     <Binary Id="CustomActions.dll" SourceFile="..\WixCustomActions\bin\Release\WixCustomActions.dll" />
     <Binary Id="MySqlConnector.dll" SourceFile="..\WixCustomActions\bin\Release\MySqlConnector.dll" />
     

   • 注册自定义动作：

     <CustomAction Id="TestDbConn" BinaryKey="CustomActions.dll" DllEntry="TestMariaDbConnection" Execute="immediate" Return="check" Impersonate="yes" />
     

     这里Execute="immediate"表示在UI阶段执行，适合测试操作；Return="check"会返回执行结果，方便我们在UI中判断。

4. 在WIX UI中添加测试按钮和结果提示
   在你的数据库凭据输入对话框里，添加一个“测试连接”按钮，触发自定义动作，并根据结果弹出提示：

   <Dialog Id="DbCredentialsDlg" Width="370" Height="270" Title="数据库配置">
       <!-- 省略用户名、密码、服务器等输入控件 -->
       
       <Control Id="TestBtn" Type="PushButton" X="20" Y="220" Width="100" Height="17" Text="测试连接">
           <Publish Event="DoAction" Value="TestDbConn">1</Publish>
           <!-- 连接成功时弹出提示 -->
           <Publish Event="SpawnDialog" Value="ConnSuccessDlg">TestDbConn = 0</Publish>
           <!-- 连接失败时弹出错误提示 -->
           <Publish Event="SpawnDialog" Value="ConnFailedDlg">TestDbConn <> 0</Publish>
       </Control>
       
       <!-- 省略Next、Back按钮 -->
   </Dialog>
   
   <!-- 连接成功对话框 -->
   <Dialog Id="ConnSuccessDlg" Width="260" Height="90" Title="连接成功">
       <Control Id="Text" Type="Text" X="40" Y="20" Width="180" Height="15" Text="数据库连接测试成功！" />
       <Control Id="OKBtn" Type="PushButton" X="100" Y="50" Width="56" Height="17" Text="确定">
           <Publish Event="EndDialog" Value="Return">1</Publish>
       </Control>
   </Dialog>
   
   <!-- 连接失败对话框 -->
   <Dialog Id="ConnFailedDlg" Width="260" Height="90" Title="连接失败">
       <Control Id="ErrorText" Type="Text" X="40" Y="20" Width="180" Height="15" Text="[CONN_ERROR_MSG]" />
       <Control Id="OKBtn" Type="PushButton" X="100" Y="50" Width="56" Height="17" Text="确定">
           <Publish Event="EndDialog" Value="Return">1</Publish>
       </Control>
   </Dialog>
   

注意事项 #

• 平台兼容性：如果你的安装包是64位的，确保自定义动作项目也设置为x64平台，否则可能出现加载dll失败的问题。
• 超时设置：连接字符串里一定要加Connection Timeout=5（或更短），避免用户长时间等待。
• 权限问题：如果测试远程数据库，Impersonate="yes"会使用当前用户的权限，一般能满足网络访问需求。
• 打包优化：可以用ILMerge之类的工具把MySqlConnector.dll和自定义动作dll合并成一个文件，减少安装包里的文件数量。

这个方案我在多个项目里用过，完全不需要用户提前安装MariaDB驱动，能有效提前发现配置错误，节省后续排障时间。

内容的提问来源于stack exchange，提问作者romixch