如何通过环境变量设置Azure部署的ASP.NET WebForms应用Web.config的compilation debug值？

因为ASP.NET的<compilation>配置节本身不支持file属性（仅appSettings和connectionStrings原生支持该特性），所以需要通过代码逻辑来实现需求，以下是两种适配BitBucket直接推送部署场景的可行方案：

方案一：通过环境变量动态修改Debug模式 #

在Global.asax的Application_Start方法中添加代码，读取环境变量并动态设置compilation的debug属性：

protected void Application_Start(object sender, EventArgs e)
{
    // 读取环境变量，Azure App Service的应用设置会自动映射为环境变量
    var debugEnv = Environment.GetEnvironmentVariable("COMPILATION_DEBUG");
    bool isDebug;
    
    // 解析环境变量值，默认设为false（本地开发环境）
    if (!bool.TryParse(debugEnv, out isDebug))
    {
        isDebug = false;
    }

    // 获取当前配置的compilation节并修改debug属性
    var compilationSection = (CompilationSection)ConfigurationManager.GetSection("system.web/compilation");
    if (compilationSection != null)
    {
        compilationSection.Debug = isDebug;
    }
}

配置方式： #

• 本地开发：直接在web.config中设置<compilation debug="false">，或者在本地环境变量中配置COMPILATION_DEBUG=false以统一逻辑。
• Azure生产环境：在Azure App Service的「配置」→「应用设置」中添加键为COMPILATION_DEBUG、值为true的项，部署后应用会自动读取该环境变量并启用Debug模式。

方案二：通过外部配置文件控制 #

如果偏好使用外部文件而非环境变量，可以创建自定义配置文件并在代码中读取：

1. 在项目根目录创建CompilationSettings.config文件，内容如下：

<compilationSettings>
  <debug value="false" />
</compilationSettings>

2. 在Global.asax的Application_Start中读取该文件并修改配置：

protected void Application_Start(object sender, EventArgs e)
{
    var configPath = Server.MapPath("~/CompilationSettings.config");
    if (File.Exists(configPath))
    {
        var doc = new XmlDocument();
        doc.Load(configPath);
        var debugNode = doc.SelectSingleNode("//compilationSettings/debug");
        if (debugNode != null)
        {
            bool isDebug;
            if (bool.TryParse(debugNode.Attributes["value"]?.Value, out isDebug))
            {
                var compilationSection = (CompilationSection)ConfigurationManager.GetSection("system.web/compilation");
                if (compilationSection != null)
                {
                    compilationSection.Debug = isDebug;
                }
            }
        }
    }
}

部署注意事项： #

• 本地开发：保持CompilationSettings.config的debug值为false。
• Azure生产环境：可以通过Azure App Service的「高级工具」→「Kudu」直接修改该文件内容，或者在BitBucket部署脚本中根据分支环境自动替换文件内容。

关键说明 #

两种方案都无需修改Web.config转换逻辑，也不需要依赖Visual Studio构建，完全适配BitBucket直接推送部署的场景。

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