ASP.NET中的Web.config是一个基于XML格式的应用程序配置文件，它在站点启动时被CLR和ASP.NET运行时自动加载，用来集中存放数据库连接串、身份认证方式、错误处理策略以及编译参数等设置。通过对该文件的修改，开发者可以在不重新编译代码的前提下调整应用行为，这也是它在日常项目中不可替代的原因。
Web.config的基本结构与层级模型
一个标准的Web.config最外层必须是<configuration>根节点，内部可以包含configSections、connectionStrings、appSettings、system.web等子节。其中configSections如果存在，必须写在根节点下的第一个位置，否则解析器会直接抛出异常。这种顺序约束是很多初学者踩坑的地方。
ASP.NET的配置具备层级继承特性。网站根目录的Web.config中的设置会对整个应用生效，而某个子目录中如果再放置一个Web.config，就可以针对该目录覆盖或补充父级的配置。例如，管理员目录可以单独设置Forms认证拒绝匿名用户，而不影响前台匿名访问。这种机制让我们能精细控制不同区域的运行规则。
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<configSections>
<section name="customSection" type="Sample.CustomSection, Sample" />
</configSections>
<appSettings>
<add key="SiteName" value="Demo" />
</appSettings>
<connectionStrings>
<add name="MainDb" connectionString="Server=.;Database=test;User Id=sa;Password=123" providerName="System.Data.SqlClient" />
</connectionStrings>
<system.web>
<compilation debug="false" targetFramework="4.8" />
<authentication mode="Forms">
<forms loginUrl="~/Login.aspx" timeout="30" />
</authentication>
</system.web>
</configuration>
常用配置节详解
connectionStrings与appSettings的区别
connectionStrings节专门用于保存数据库连接信息，且支持providerName属性，方便后续通过ConfigurationManager.ConnectionStrings按名称获取并自动匹配ADO.NET提供程序。把密码写在这里时，若包含&、<等XML特殊字符，必须使用实体转义，如&，否则文件无法解析。
appSettings则更适合存放业务开关、第三方接口地址、缓存时间等轻量参数。读取时调用ConfigurationManager.AppSettings["Key"]即可。两者都支持在子目录Web.config中用同名节进行增删改，但appSettings还支持file属性指向外部配置文件，实现配置与代码包的物理分离。
// 读取连接串
string conn = System.Configuration.ConfigurationManager
.ConnectionStrings["MainDb"].ConnectionString;
// 读取自定义设置
string siteName = System.Configuration.ConfigurationManager
.AppSettings["SiteName"];
system.web中的核心子节
system.web是ASP.NET运行参数的核心容器。其中的compilation节控制是否开启调试符号与目标框架版本；authentication决定站点采用Forms、Windows还是None认证；customErrors则定义异常时跳转的友好页面。错误地把mode写成Mode也会导致配置失效，因为XML节点与属性均区分大小写。
另一个易忽略的是httpRuntime节，它可以限制最大请求长度、执行超时时间。上传大文件时若未调整maxRequestLength，默认4MB就会让请求被拒。下面示例展示了如何放开到20MB并延长超时：
<system.web>
<httpRuntime maxRequestLength="20480" executionTimeout="300" />
<customErrors mode="RemoteOnly" defaultRedirect="~/Error.aspx">
<error statusCode="404" redirect="~/NotFound.aspx" />
</customErrors>
</system.web>
配置变换与发布策略
在Visual Studio中，我们可以通过Web.Debug.config与Web.Release.config实现变换（Transform）。利用xdt:Transform指令，在发布时自动把调试用的debug="true"改为生产环境的false，避免敏感信息泄露和性能损耗。这种方式比手动改文件更安全，也便于纳入版本管理。
例如，下面的Release变换会把连接串指向生产数据库，并关闭自定义错误详情：
<configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
<connectionStrings>
<add name="MainDb"
connectionString="Server=prod;Database=main;User Id=app;Password=secret"
xdt:Transform="SetAttributes" xdt:Locator="Match(name)" />
</connectionStrings>
<system.web>
<compilation xdt:Transform="RemoveAttributes(debug)" />
</system.web>
</configuration>
常见错误与排查建议
当站点报出“Configuration Error”时，首先应查看黄色异常页中指出的行号，多数是标签未闭合或属性拼错。其次，IIS经典管道与集成管道对某些system.webServer节的写法要求不同，若从旧项目迁移，需要补上system.webServer/handlers配置。最后，务必确认文件编码为UTF-8无BOM，否则中文注释可能让解析失败。
建议在本地用aspnet_regiis或VS的配置管理器提前校验，再推送到服务器。对敏感连接串还可使用aspnet_regiis -pe进行加密，这样即便Web.config被下载，明文密码也不会暴露。掌握这些细节，才能让ASP.NET配置真正服务于稳定交付。
ASP.NETWeb_configconfiguration修改时间：2026-08-12 01:21:37