Wix C#自定义操作未触发，如何基于Wix 3.10定制SQL Server安装程序？

嘿，针对你遇到的两个Wix Toolset问题，我来给你梳理下实际项目里验证过的解决方案，都是能快速定位和解决的思路：

这类问题大多是配置遗漏或执行时机/权限不对，按下面的步骤逐一排查：

• 先确认自定义操作项目类型正确：
  你必须用Wix Toolset提供的C# Custom Action项目模板，不是普通的Class Library。因为Wix要求自定义操作程序集引用Microsoft.Deployment.WindowsInstaller（DTF库），并且方法要标记[CustomAction]特性，或者类继承System.Configuration.Install.Installer——普通类库编译出来的DLL是不被MSI识别的。

• 检查Wix主工程里的配置是否完整：

  1. 先在Product.wxs中添加Binary元素，指向Wix编译后的自定义操作包装DLL（注意是.CA.dll，不是你写的原始DLL）：

     <Binary Id="CustomActionsDll" SourceFile="$(var.MyCustomActions.TargetDir)$(var.MyCustomActions.TargetName).CA.dll" />
     

  2. 定义CustomAction元素，指定正确的DllEntry（就是你标记了[CustomAction]的方法名）：

     <CustomAction Id="MyCustomAction" BinaryKey="CustomActionsDll" DllEntry="MyActionMethod" Execute="immediate" Impersonate="no" />
     

     👉 如果你的操作需要修改系统状态（比如写注册表、复制文件），一定要把Execute设为deferred，同时Impersonate="no"——immediate模式用当前用户权限，很可能因为权限不足执行失败。
  3. 把自定义操作添加到正确的安装序列中，比如在InstallExecuteSequence里：

     <InstallExecuteSequence>
       <Custom Action="MyCustomAction" After="InstallFiles">NOT Installed</Custom>
     </InstallExecuteSequence>
     

     条件NOT Installed确保只在首次安装时触发，根据你的需求调整即可。

• 排查执行日志与权限问题：
  运行安装包时加日志参数：msiexec /i YourSetup.msi /l*v install.log，然后在日志里搜索你的自定义操作ID（比如MyCustomAction），看有没有报错信息——常见的有DLL找不到、方法名拼写错误、权限不足等。

• 调试自定义操作：
  在你的自定义操作方法里加一行System.Diagnostics.Debugger.Launch();，运行安装包时会弹出调试器选择窗口，附加到进程后就能一步步断点调试，确认代码是否真的执行了。

你的需求是实现类似批处理的静默安装，同时支持每个客户的专属产品密钥，用Wix Bundle（引导程序）来实现是最优解，因为它可以打包第三方安装包并动态传递参数：

• 步骤1：创建Wix Bundle工程：
  新建一个Wix的Bootstrapper Project（也就是Bundle项目），把SQL Server的安装介质（setup.exe+所有安装文件）放到Bundle工程的资源目录下（比如新建SQLMedia文件夹）。

• 步骤2：定义产品密钥变量：
  在Bundle.wxs里定义一个可外部传入的变量，用来接收产品密钥，同时隐藏避免日志明文泄露：

  <Variable Id="SQLProductKey" Type="string" Hidden="yes" />
  

  如果需要让用户在UI里输入密钥，可以添加自定义对话框，把输入值绑定到这个变量上。

• 步骤3：配置SQL Server的安装包：
  在Chain节点里添加ExePackage，传递你需要的所有批处理参数，重点把产品密钥变量传入：

  <Chain>
    <ExePackage
      Id="SQLServerSetup"
      SourceFile=".\SQLMedia\setup.exe"
      InstallCommand="/Action=Install /Q /IACCEPTSQLSERVERLICENSETERMS /SECURITYMODE=SQL /SAPWD=hoge_for_fuga /InstanceName=MYINSTANCE /PID=[SQLProductKey]"
      RepairCommand="/Action=Repair /Q /IACCEPTSQLSERVERLICENSETERMS"
      UninstallCommand="/Action=Uninstall /Q /IACCEPTSQLSERVERLICENSETERMS"
      DetectCondition="SQLInstanceExists"
      />
  </Chain>
  

  客户安装时只需通过命令行传入密钥：YourBundle.exe SQLProductKey=XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

• 步骤4：添加实例存在检测：
  为了避免重复安装，需要检测目标机器是否已经存在指定的SQL实例，用RegistrySearch实现：

  <util:RegistrySearch
    Id="CheckSQLInstance"
    Root="HKLM"
    Key="SOFTWARE\Microsoft\Microsoft SQL Server\Instance Names\SQL"
    Value="MYINSTANCE"
    Variable="SQLInstanceExists"
    />
  

  这个变量会在检测到实例时被设为1，作为ExePackage的DetectCondition，避免重复安装。

• 额外优化：SA密码动态传入：
  如果不想把SA密码硬编码，也可以定义SAPwd变量，让用户通过命令行传入，把InstallCommand里的/SAPWD=hoge_for_fuga改成/SAPWD=[SAPwd]即可。

• 注意事项：

  • 不同版本的SQL Server命令行参数可能略有差异，要对应你使用的版本调整；
  • 确保SQL安装介质完整，或者用/SourcePath指定网络安装源；
  • 测试时一定要加日志：YourBundle.exe /l*v bundle.log，方便排查安装失败的原因。

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