DbUp变量替换功能疑似未生效，请求技术排查解决

安全阿岳

2026-7-9

DbUp变量替换未生效的解决办法

你的问题核心在于DbUp默认的变量占位符语法与你脚本中使用的格式不匹配，导致变量替换操作未执行。

解决方案1：改用DbUp默认变量语法

DbUp默认使用@变量名作为占位符格式，将SQL脚本里的 $UsersMetaDataConstraintName$ 替换为@UsersMetaDataConstraintName即可：

IF (LEN('@UsersMetaDataConstraintName') > 0)
BEGIN
  ALTER TABLE UsersMetadata DROP CONSTRAINT @UsersMetaDataConstraintName
  GO
END

ALTER TABLE UsersMetadata ALTER COLUMN UserId NCHAR(6) NOT NULL;
GO

ALTER TABLE UsersMetadata ADD CONSTRAINT PK_UserId PRIMARY KEY (UserId)
GO

解决方案2：自定义变量分隔符（保留$符号格式）

如果必须保留 $变量名$ 的格式，需要在DbUp配置中添加自定义变量语法的设置，在WithVariablesEnabled()之后追加WithVariablesSyntax配置：

var upgrader =
DbUp.DeployChanges.To
    .SqlDatabase(new MicrosoftDataSqlClientConnectionManager(connection))
    .WithScriptsEmbeddedInAssembly(ThisAssembly, filter: scriptName => performRegex(scriptName).Success)
    .WithVariablesEnabled()
    // 指定变量前后分隔符为$
    .WithVariablesSyntax(new DbUp.Engine.Variables.SqlScriptVariableSyntax("$", "$"))
    .WithVariables(new System.Collections.Generic.Dictionary<string, string>
    {
        {"UsersMetaDataConstraintName", usersMetaDataConstraintName ?? string.Empty}
    })
    .LogToConsole()
    .Build();