凌晨两点在机房Windows Server 2012 的添加角色和功能向导跑到第三步勾上 .NET Framework 3.5 之后进度条刚爬了两格就退回来红字写着安装一个或多个角色、角色服务或功能失败下面跟着一行找不到源文件错误代码 0x800F081F。这个画面我见过太多次尤其是在内网隔离的服务器上。问题本身一点都不复杂但每年还是会有人栽在这上面根子在于大多数人把 .NET 3.5 当成一个下载回来双击就能装的安装包而 Server 2012 从这一代开始它是按需功能Features on Demand安装逻辑和你脑子里那套完全不是一回事。下面我打算把 Server 2012 上 .NET 3.5 装不上的几种典型场景全部捋一遍报错到底在找哪个文件、离线机器怎么用安装镜像补源、内网接了 WSUS 之后为什么明明指定了源还是失败、镜像里根本没有 sxs 目录时的替代路径以及我自己踩过的几个具体坑。文中的命令都可以直接复制粘贴执行参数我会逐个解释为什么这么写而不是那么写。适合经常要交付内网服务器、装完系统还得补运行库的运维和交付同学看也适合第一次撞上这个报错、手边只有一台机器要临时救急的人。1. 找不到源文件这句话系统到底在找什么1.1 NetFx3 从这一代起就不是独立安装包了从 Windows 8 和 Windows Server 2012 开始微软把 .NET Framework 3.5 从系统预装组件里挪了出去改成了按需功能。所谓按需功能意思是系统里只留一份功能清单和几个存根真正干活的二进制文件DLL、资源、配置全部被打包放进安装介质的sources\sxs目录只有在你显式启用这个功能的时候才会被拉进来。这么做的好处是基础镜像更小、系统盘占用更低代价就是安装时必须有一个可用的载荷来源否则功能清单勾得再漂亮也装不上。作为对比Server 2012 自带的是 .NET Framework 4.5它属于系统核心组件装完就在不需要额外操作。很多人被这个现象误导以为既然 4.5 都在了3.5 应该也能顺手装上结果一点就报错。其实 3.5 和 4.x 是两套完全独立的运行时代码库、CLR 版本、GAC 目录都不一样谁也不能替代谁老一点的业务系统、某些行业软件、一些只编译到 v2.0/v3.5 的程序集缺了 3.5 就是起不来。安装 NetFx3 只有两条合法路径。第一条是让系统去 Windows 更新的按需功能通道下载载荷这条路需要机器能出网、更新服务没被禁用、组策略也允许回退到 Windows 更新第二条是从本地源安装也就是把sources\sxs这个目录喂给 DISM。绝大多数报错本质都是第一条走不通而第二条又没提供系统在原地干着急。1.2 几个高频错误码含义差别很大很多人看到红色报错就只记住找不到源文件这几个字其实错误码才是真正的线索它们指向的原因完全不同处理方式也不一样。错误码界面上的说法实际指向的问题0x800F0906无法下载源文件系统试图从 Windows 更新拉载荷但网络受限、更新服务被停用或出网被限制0x800F081F找不到源文件本地源路径为空或指定路径下没有匹配的载荷文件0x800F0907DISM 失败组策略里的指定可选组件安装和组件修复的设置把 Windows 更新这条路堵死了0x800F0954无法下载源文件机器受 WSUS 管理按需功能载荷没有从内网更新源拿到这里要特别说一句 0x800F0906 和 0x800F081F 的区别。前者是我想去网上拿但拿不到后者是我压根没找到本地源。同样是找不到源文件的提示前者你去配置 WSUS 或者放开更新通道可能就解决了后者你去配网络纯属白费劲必须老老实实准备 sxs 目录。分不清这两个排查方向就会完全跑偏我在现场见过有人为了 0x800F081F 折腾了一整天的防火墙策略。1.3 动手之前先用三条命令把病因定下来在动手改任何配置之前先花两分钟把现状摸清楚比上来就乱试要省事得多。下面这几条命令我在每台出问题的机器上都会先跑一遍。第一条看功能当前状态和是否声明需要源文件dism /online /get-featureinfo /featurename:NetFx3输出里State : Disabled说明功能没启用后面如果有提示说明该功能需要外部源才能安装那就基本确认是载荷缺失。第二条看这台机器有没有被 WSUS 接管reg query HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU /v UseWUServer返回0x1就说明更新通道被内网 WSUS 接管了这种情况下系统不会主动去公网取按需功能载荷。第三条看本地源路径有没有配过reg query HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing重点看LocalSourcePath和RepairContentServerSource两个值。前者是备用源路径后者决定要不要联系 Windows 更新0 未配置、1 不联系、2 联系。如果想看得更细直接翻 DISM 日志Get-Content C:\Windows\Logs\DISM\dism.log -Tail 120日志里会明确写出它尝试了哪个路径、在哪个环节放弃的。掌握了这三条命令的输出后面选哪套方案就是明摆着的事了。2. 首选解法把安装镜像里的 sxs 目录喂给 DISM2.1 挂载 ISO 还是先把 sxs 拷到硬盘手上有 Server 2012 的安装 ISO标准做法是挂载后直接指向里面的sources\sxs。挂载用 PowerShell 一行就够$img Mount-DiskImage -ImagePath D:\ISO\WS2012R2_x64.iso -PassThru ($img | Get-Volume).DriveLetter最后那行会吐出盘符比如E。卸载的时候对着路径再来一次Dismount-DiskImage -ImagePath D:\ISO\WS2012R2_x64.iso不过我更推荐多做一步把 sxs 目录复制到本地硬盘再指向本地路径。原因有三个挂载出来的盘符是一次性的机器一重启就没了如果后续还要给别的服务器装你得重新挂ISO 挂载盘如果在安装过程中被误弹出DISM 会直接中断留下一个半死不活的功能状态而且把 sxs 放在本地配合组策略可以做到后面所有同版本机器自动复用长期看省的事不是一点半点。复制用 robocopy 最稳注意它的返回码robocopy E:\sources\sxs C:\sources\sxs /E /NFL /NDL这里有个老坑robocopy 执行成功并且确实复制了文件时返回码是 1 而不是 0很多批处理脚本里if %errorlevel%0判断就会误判成失败。真正代表出错的是 8 及以上。2.2 DISM 命令的每个参数都值得说清楚源准备好之后核心命令就一行dism /online /enable-feature /featurename:NetFx3 /all /source:C:\sources\sxs /limitaccess逐段拆开看/online作用于当前正在运行的系统而不是离线镜像。/enable-feature /featurename:NetFx3启用名为 NetFx3 的功能这是 DISM 层面对 .NET Framework 3.5 的固定叫法不要写成 NetFx35 或者 NetFramework3.5名称一个字都不能错。/all连同该功能的父功能一起处理。NetFx3 在功能树里有上层节点漏掉/all有时候装完能启用但子组件不全跑老程序照样报错。/source:C:\sources\sxs告诉 DISM 载荷在哪里。注意路径必须指到 sxs 目录本身指到 ISO 根目录或者sources上一层都不行这是最常见的填错方式。/limitaccess禁止 DISM 在本地源不完整时回退去联系 Windows 更新。关于/limitaccess我要多说几句因为这是内网环境里最容易漏的参数。不写它的时候DISM 会先试本地源一旦发现缺了点什么就转身去问 Windows 更新而内网机器问不通于是它会一直等到超时最后抛出一个 0x800F0906让你误以为是本地源有问题。实际上本地源好好的坑就在这个回退行为上。2.3 PowerShell 版本的写法与功能名差异如果你更习惯 PowerShell等价命令是Install-WindowsFeature -Name NET-Framework-Core -Source C:\sources\sxs用之前先用下面这条把功能名确认一遍因为不同系统版本里这个功能的名字不一样Get-WindowsFeature *NET*在 Server 2012 和 2012 R2 上.NET 3.5 对应的功能名是NET-Framework-Core到了 Server 2016 及以后功能名变成了NET-Framework-Features它同时覆盖 3.5 和 4.x。名字写错的话PowerShell 会直接告诉你找不到该功能不会给你任何猜测的余地。还有一个差异值得注意Install-WindowsFeature的-Source参数在 Server 2012 上是有的但在更老的 Server 2008 R2 上对应的Add-WindowsFeature根本没有这个参数只能靠组策略里的LocalSourcePath或者修改注册表来指定源。如果你手上还混着 2008 R2 的机器这一点要单独记一下不要拿 2012 的命令去套。2.4 装完怎么确认别只看界面上的成功图形界面或者命令返回成功之后我习惯再验证三处确保功能真的落地了而不是清单层面打了个勾。第一处功能状态Get-WindowsFeature NET-Framework-CoreInstall State显示Installed才算数。第二处注册表标记reg query HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.5 /v Install返回0x1说明运行时层面的安装标记已经写入。第三处目录是否存在dir C:\Windows\Microsoft.NET\Framework\v3.5这个目录里有 csc.exe、mscorlib.dll 之类的核心文件才说明二进制真的进来了。最后拿一个实际用到 3.5 的程序跑一遍。最轻量的验证方式是在 PowerShell 里加载一个老版本才有的程序集比如Add-Type -AssemblyName System.Web能加载成功基本就没问题了。如果这台服务器上本来就跑着依赖 3.5 的业务程序直接把它拉起来看日志更直观。3. 内网 WSUS 环境指定了源为什么还是失败3.1 UseWUServer 是怎么把安装请求劫走的这是最让人困惑的一类故障源明明指定得没错路径也确认存在可还是报错。原因在于受 WSUS 管理的机器上Windows 更新客户端wuauserv 服务被策略改写成只连内网更新服务器而按需功能这类载荷在内网 WSUS 上通常没有同步或者根本没走 WSUS 的分发机制。系统在需要下载载荷时会去问更新客户端客户端回复我这儿没有于是报 0x800F0954 或者 0x800F0906。这个机制带来的一个直接结论是在内网环境里最可靠的永远是本地源不要去指望更新通道。很多人第一反应是去修 WSUS 服务器、往里面塞更新分类折腾半天发现这条路根本不通方向从一开始就选错了。正确的姿势是准备好 sxs 目录配上/limitaccess让系统彻底不去碰更新通道。3.2 万一确实需要走更新通道摘除的顺序别搞反有些场景下你确实没法准备本地源比如服务器在很远的机房手上只有这一台机器只能试试从更新通道拿。这时候需要临时把 WSUS 通道摘掉但顺序很重要直接改键不重启服务是不生效的。先把原值记下来别改完忘了改回去reg query HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU /v UseWUServer然后把值改成 0并且按顺序重启相关服务reg add HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU /v UseWUServer /t REG_DWORD /d 0 /f net stop wuauserv net stop bits net start bits net start wuauserv注意是停 wuauserv 和 bits 两个服务先停 wuauserv 再停 bits启动时反过来先起 bits 再起 wuauserv。只重启其中一个策略有时候加载不进去这个细节在微软文档里也是这么写的但很多教程都略过去了。装完之后把值改回 1 并再重启一次服务否则这台机器就脱离内网补丁管理体系了后面合规检查会找你麻烦。3.3 组策略里那三项配置分别管什么路径是计算机配置 → 管理模板 → 系统 → 指定可选组件安装和组件修复的设置。这个策略展开后有三个关键项我见过太多人只勾了一半然后回来报错。第一项是策略总开关。设为已启用才会读取下面的配置设为未配置时系统走默认行为而默认行为在不同版本上还不一样很坑。第二项是联系 Windows 更新以获取修复内容。勾上系统就允许去 Windows 更新拉按需功能载荷不勾就只认本地源。内网机器上我一般不勾并且把备用源路径填好这样安装过程不会去等网络超时。第三项是从不安装来自 Windows 更新的更新这个在功能修复场景下容易被忽略。勾上它会彻底封死回退路径配合本地源用是合理的但如果你既没本地源又勾了它那就是自己把自己的路堵死了。对应的注册表键在HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing下面RepairContentServerSource这个 DWORD 值的含义是0 表示未配置1 表示不联系 Windows 更新2 表示联系 Windows 更新。LocalSourcePath是字符串类型填备用源路径。3.4 LocalSourcePath配一次后面所有机器都省事如果你管着一批同版本的服务器每台都手动喂源太累了。这时候把LocalSourcePath配到一个统一位置就行了。域环境里可以走组策略下发工作组的机器就在部署脚本里写注册表reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v LocalSourcePath /t REG_EXPAND_SZ /d D:\sources\sxs /f reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v RepairContentServerSource /t REG_DWORD /d 1 /f这里把RepairContentServerSource设成 1是因为内网完全隔离的环境里让系统去尝试联系 Windows 更新只会白白等超时不如直接告诉它只认本地源。配上这个之后添加角色和功能向导里勾 .NET 3.5 就能一路装完不用每次手动填路径。如果要指向网络共享比如\\fileserver\sources\sxs有一点必须注意访问共享的是计算机账户不是登录用户。共享权限和安全权限里都要把域计算机组加进去给读取权限否则会出现路径存在但 DISM 说访问不了的怪现象这个坑我踩过排查起来特别费劲因为用资源管理器手动访问是通的你会下意识觉得权限没问题。4. 手里没有带 sxs 的镜像怎么办4.1 从 install.wim 现场提取载荷有些企业定制镜像或者精简过的安装介质sources\sxs目录被删掉了ISO 拿到手发现里面只有 install.wim。这种情况下有两条路可以试。第一条是直接让 DISM 从 WIM 里取源。较新版本的 DISM 支持这种写法dism /online /enable-feature /featurename:NetFx3 /all /source:WIM:E:\sources\install.wim:2 /limitaccess冒号后面的数字是镜像索引先用下面这条命令确认一下目标镜像在第几号dism /Get-WindowsImage /ImageFile:E:\sources\install.wim需要提醒的是/Source:WIM:这个语法在不同版本的 DISM 上支持程度不一样Server 2012 原版自带的 DISM 6.2 未必认。如果执行时报参数错误别在这上面死磕换第二条路。第二条是把 WIM 挂载起来从挂载后的目录里找载荷dism /Mount-Wim /WimFile:E:\sources\install.wim /Index:2 /MountDir:C:\wimmount /ReadOnly挂载完成后到C:\wimmount\Windows\WinSxS下面翻。但说实话WinSxS 里的文件是硬链接形态直接拷贝出来经常不能用所以这条路更多是给你确认文件确实在而不是当作可用的源。用完记得卸载不然挂载目录会一直被占用dism /Unmount-Wim /MountDir:C:\wimmount /Discard4.2 从同版本同语言的机器上取源另一个思路是在手边找一台已经装好 .NET 3.5、版本和语言都一致的 Server 2012把它的安装介质里的 sxs 拿过来用。注意这里说的是介质里的 sxs不是从系统盘里抠文件系统盘里的 WinSxS 不适合直接当源。如果实在找不到原始介质可以考虑用官方的批量授权渠道重新下载一份对应版本的 ISO这是最省心的做法。网上流传的各种sxs 压缩包NetFx3 离线包来源不明的我一般不碰因为按需功能载荷和系统版本严格绑定装错了轻则报错重则把组件存储搞坏后面要花更多时间修。真要用第三方整理的包至少先核一下文件版本号和数字签名。4.3 版本号和语言这两个条件必须同时满足这是非常硬性的一条规则sxs 载荷的版本和语言必须与目标系统完全一致。版本层面Server 2012 是 6.2 分支Server 2012 R2 是 6.3 分支两者的 sxs 不能互换。拿 2012 R2 的介质去给 2012 装DISM 通常会直接报源不匹配偶尔有能装进去的后续也会出各种诡异问题。语言层面中文版系统配英文版 sxs大部分情况装不上少数能装上的也会在运行老程序时因为资源文件缺失而报错。判断语言版本看 ISO 文件名里的cn或者en标识最直接系统侧可以用下面这条确认dism /online /get-intl会输出系统当前的区域和语言设置。先确认这两项对得上再去准备源能省掉大量无效尝试。5. 那些年我在这个报错上踩过的具体坑5.1 路径里有空格却忘了加引号看起来是低级错误但真的高频。如果 sxs 目录放在D:\My Files\sources\sxs这种带空格的路径下命令必须写成dism /online /enable-feature /featurename:NetFx3 /all /source:D:\My Files\sources\sxs /limitaccess不加引号的话DISM 会把路径在空格处截断然后告诉你找不到源文件。你去看那个截断后的路径发现确实不存在但如果不去细想很容易得出sxs 目录有问题的错误结论。我现在干脆把源统一放在C:\sources\sxs这种绝对没有空格的路径下从根本上避免这个问题。5.2 /LimitAccess 漏写导致白等十几分钟前面提过一次这里再强调因为它浪费的时间成本太高。内网机器上只写/source不写/limitaccessDISM 会先读本地源发现内容不完全匹配就回退到 Windows 更新然后在内网里一路超时整个过程可能持续十几分钟最后抛一个 0x800F0906。你看着这个错误码以为是源的问题换了几个源反复试其实是参数没写全。我的习惯是把这条命令做成一个固定脚本参数写死谁需要谁拿去跑避免每个人凭记忆敲命令漏参数。5.3 半途中断留下的组件状态怎么收拾安装过程中断电、强制重启或者手滑关掉向导都会留下一个挂起的功能状态之后再装会提示有操作未完成。先检查一下reg query HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending如果有输出最简单的处理方式是重启一次让挂起操作落地然后再重新执行安装命令。如果重启之后还是不行可以看一眼 CBS 日志里的具体错误Select-String -Path C:\Windows\Logs\CBS\CBS.log -Pattern NetFx3 | Select-Object -Last 30这里要特别区分一个容易混淆的点/RestoreHealth用的源和 NetFx3 用的源不是同一个东西。下面这条命令看着像那么回事其实源的类型不对dism /online /cleanup-image /restorehealth /source:C:\sources\sxs /limitaccessRestoreHealth需要的是完整的组件存储镜像通常来自同版本机器的C:\Windows\WinSxS或者挂载后的 install.wim 目录而不是sources\sxs。拿 sxs 去喂 RestoreHealth大概率报源无效。这两件事在论坛上经常被写混照着抄很容易走进死胡同。5.4 图形界面向导里那个源路径框填什么带桌面体验的版本可以用添加角色和功能向导走到最后一步会出现一个指定备用源路径的输入框。这里填的必须是sxs 目录本身也就是E:\sources\sxs而不是 ISO 根目录E:\也不是E:\sources。填错的表现通常是向导跑一会儿然后失败报的还是找不到源文件。因为界面上没有明确提示它期望的是哪个层级很多人会下意识填盘符根目录。我的建议是能用命令行就用命令行路径填错会立刻报错比向导跑一遍再失败要省时间。5.5 Server Core 上的操作差异Server Core 没有图形界面添加角色和功能向导根本打不开只能靠 DISM 或者 PowerShell 的Install-WindowsFeature。命令本身和前面写的一样但要留意 Server Core 上默认没有 .NET 3.5 相关的任何图形依赖装完之后如果要跑 .NET 2.0/3.5 编译的老程序记得确认对应的 32 位子系统支持也正常因为很多老业务程序是 32 位的走的是 WOW64 通道。6. 同一套思路在 Windows 10 和 11 上照样管用6.1 机制没变变的只是路径和功能名桌面版 Windows 从 8 开始用的也是同一套按需功能机制所以 Windows 10、Windows 11 上装 .NET 3.5 报的错、报错码、处理思路几乎一模一样。命令还是那一条dism /online /enable-feature /featurename:NetFx3 /all /source:D:\sources\sxs /limitaccess把 D 换成挂载后的 ISO 盘符就行。区别在于 Windows 10/11 的安装 ISO 里sources\sxs同样存在但体积比服务器版小一些因为它只带 NetFx3 相关的载荷。需要额外注意的是Windows 11 上通过设置 → 应用 → 可选功能去添加 .NET 3.5 时系统默认会去 Windows 更新拉载荷离线环境下必然失败而且界面上给的提示非常模糊只说安装失败不给具体错误码。这种情况直接绕开图形界面用 DISM 命令行指定本地源比在设置里反复点要高效。6.2 离线 cab 包什么时候能用微软官方确实提供过按需功能包Features on Demand里面有针对 NetFx3 的 cab 文件可以用下面这种方式安装dism /online /add-package /packagepath:D:\FoD\Microsoft-Windows-NetFx3-OnDemand-Package~31bf3856ad364e35~amd64~~.cab这个做法在 Windows 10 的部分版本上是可行的但有一条硬性约束cab 包的版本必须和系统内部版本号严格对应。比如 22H2 的包只能喂给 22H2 的系统跨版本装基本都会失败。至于预览版通道的系统对应的 FoD 包往往拿不到这种时候还是回到最原始的办法——用对应版本的 ISO 里的 sxs 目录。所以我的排序是优先本地 ISO 的 sxs其次才考虑 FoD 包。前者几乎不会出错后者要核对版本多一道工序。6.3 把源目录写进装机模板如果你经常批量装机有个一劳永逸的做法在系统部署脚本里就把源目录和注册表项准备好。比如在镜像里预留一个D:\sources\sxs把对应版本的 sxs 目录塞进去然后在首次启动脚本里写两条注册表reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v LocalSourcePath /t REG_EXPAND_SZ /d D:\sources\sxs /f reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v RepairContentServerSource /t REG_DWORD /d 1 /f这么配完之后后续不管是装 .NET 3.5、开 IIS 的某些组件还是触发组件修复系统都会自动从本地目录取文件不用再有人记得去挂 ISO。这套做法我在几个交付项目里用过效果比事后补救好得多尤其是当装机的人和用机的人不是同一批的时候。要注意的是sxs 目录会占用几百兆到一两个 G 的空间如果磁盘紧张可以只在装机阶段临时放装完之后清理掉但注册表里的LocalSourcePath记得要么删掉要么改到有效路径否则以后组件修复时会因为找不到源而报一堆错。我个人在实际操作中的体会是.NET 3.5 装不上这件事麻烦从来不在技术难度而在于信息不全——你不知道系统去哪找、找了什么、为什么没找到。把三条诊断命令跑一遍确认是本地源缺失还是更新通道被接管然后对症下药多数情况十分钟内就能解决。真正耗时间的永远是那些凭着印象敲命令、漏了关键参数还不自知的时刻所以我现在宁可多花两分钟把参数对着文档核一遍也不愿意事后翻半小时日志。最后再分享一个小技巧把那条完整的 DISM 安装命令连同注释存成一个.bat放到服务器的工具目录里下次遇到同类问题直接双击比现查资料快得多也能避免手抖漏参数。
凌晨两点在机房Windows Server 2012 的添加角色和功能向导跑到第三步勾上 .NET Framework 3.5 之后进度条刚爬了两格就退回来红字写着安装一个或多个角色、角色服务或功能失败下面跟着一行找不到源文件错误代码 0x800F081F。这个画面我见过太多次尤其是在内网隔离的服务器上。问题本身一点都不复杂但每年还是会有人栽在这上面根子在于大多数人把 .NET 3.5 当成一个下载回来双击就能装的安装包而 Server 2012 从这一代开始它是按需功能Features on Demand安装逻辑和你脑子里那套完全不是一回事。下面我打算把 Server 2012 上 .NET 3.5 装不上的几种典型场景全部捋一遍报错到底在找哪个文件、离线机器怎么用安装镜像补源、内网接了 WSUS 之后为什么明明指定了源还是失败、镜像里根本没有 sxs 目录时的替代路径以及我自己踩过的几个具体坑。文中的命令都可以直接复制粘贴执行参数我会逐个解释为什么这么写而不是那么写。适合经常要交付内网服务器、装完系统还得补运行库的运维和交付同学看也适合第一次撞上这个报错、手边只有一台机器要临时救急的人。1. 找不到源文件这句话系统到底在找什么1.1 NetFx3 从这一代起就不是独立安装包了从 Windows 8 和 Windows Server 2012 开始微软把 .NET Framework 3.5 从系统预装组件里挪了出去改成了按需功能。所谓按需功能意思是系统里只留一份功能清单和几个存根真正干活的二进制文件DLL、资源、配置全部被打包放进安装介质的sources\sxs目录只有在你显式启用这个功能的时候才会被拉进来。这么做的好处是基础镜像更小、系统盘占用更低代价就是安装时必须有一个可用的载荷来源否则功能清单勾得再漂亮也装不上。作为对比Server 2012 自带的是 .NET Framework 4.5它属于系统核心组件装完就在不需要额外操作。很多人被这个现象误导以为既然 4.5 都在了3.5 应该也能顺手装上结果一点就报错。其实 3.5 和 4.x 是两套完全独立的运行时代码库、CLR 版本、GAC 目录都不一样谁也不能替代谁老一点的业务系统、某些行业软件、一些只编译到 v2.0/v3.5 的程序集缺了 3.5 就是起不来。安装 NetFx3 只有两条合法路径。第一条是让系统去 Windows 更新的按需功能通道下载载荷这条路需要机器能出网、更新服务没被禁用、组策略也允许回退到 Windows 更新第二条是从本地源安装也就是把sources\sxs这个目录喂给 DISM。绝大多数报错本质都是第一条走不通而第二条又没提供系统在原地干着急。1.2 几个高频错误码含义差别很大很多人看到红色报错就只记住找不到源文件这几个字其实错误码才是真正的线索它们指向的原因完全不同处理方式也不一样。错误码界面上的说法实际指向的问题0x800F0906无法下载源文件系统试图从 Windows 更新拉载荷但网络受限、更新服务被停用或出网被限制0x800F081F找不到源文件本地源路径为空或指定路径下没有匹配的载荷文件0x800F0907DISM 失败组策略里的指定可选组件安装和组件修复的设置把 Windows 更新这条路堵死了0x800F0954无法下载源文件机器受 WSUS 管理按需功能载荷没有从内网更新源拿到这里要特别说一句 0x800F0906 和 0x800F081F 的区别。前者是我想去网上拿但拿不到后者是我压根没找到本地源。同样是找不到源文件的提示前者你去配置 WSUS 或者放开更新通道可能就解决了后者你去配网络纯属白费劲必须老老实实准备 sxs 目录。分不清这两个排查方向就会完全跑偏我在现场见过有人为了 0x800F081F 折腾了一整天的防火墙策略。1.3 动手之前先用三条命令把病因定下来在动手改任何配置之前先花两分钟把现状摸清楚比上来就乱试要省事得多。下面这几条命令我在每台出问题的机器上都会先跑一遍。第一条看功能当前状态和是否声明需要源文件dism /online /get-featureinfo /featurename:NetFx3输出里State : Disabled说明功能没启用后面如果有提示说明该功能需要外部源才能安装那就基本确认是载荷缺失。第二条看这台机器有没有被 WSUS 接管reg query HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU /v UseWUServer返回0x1就说明更新通道被内网 WSUS 接管了这种情况下系统不会主动去公网取按需功能载荷。第三条看本地源路径有没有配过reg query HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing重点看LocalSourcePath和RepairContentServerSource两个值。前者是备用源路径后者决定要不要联系 Windows 更新0 未配置、1 不联系、2 联系。如果想看得更细直接翻 DISM 日志Get-Content C:\Windows\Logs\DISM\dism.log -Tail 120日志里会明确写出它尝试了哪个路径、在哪个环节放弃的。掌握了这三条命令的输出后面选哪套方案就是明摆着的事了。2. 首选解法把安装镜像里的 sxs 目录喂给 DISM2.1 挂载 ISO 还是先把 sxs 拷到硬盘手上有 Server 2012 的安装 ISO标准做法是挂载后直接指向里面的sources\sxs。挂载用 PowerShell 一行就够$img Mount-DiskImage -ImagePath D:\ISO\WS2012R2_x64.iso -PassThru ($img | Get-Volume).DriveLetter最后那行会吐出盘符比如E。卸载的时候对着路径再来一次Dismount-DiskImage -ImagePath D:\ISO\WS2012R2_x64.iso不过我更推荐多做一步把 sxs 目录复制到本地硬盘再指向本地路径。原因有三个挂载出来的盘符是一次性的机器一重启就没了如果后续还要给别的服务器装你得重新挂ISO 挂载盘如果在安装过程中被误弹出DISM 会直接中断留下一个半死不活的功能状态而且把 sxs 放在本地配合组策略可以做到后面所有同版本机器自动复用长期看省的事不是一点半点。复制用 robocopy 最稳注意它的返回码robocopy E:\sources\sxs C:\sources\sxs /E /NFL /NDL这里有个老坑robocopy 执行成功并且确实复制了文件时返回码是 1 而不是 0很多批处理脚本里if %errorlevel%0判断就会误判成失败。真正代表出错的是 8 及以上。2.2 DISM 命令的每个参数都值得说清楚源准备好之后核心命令就一行dism /online /enable-feature /featurename:NetFx3 /all /source:C:\sources\sxs /limitaccess逐段拆开看/online作用于当前正在运行的系统而不是离线镜像。/enable-feature /featurename:NetFx3启用名为 NetFx3 的功能这是 DISM 层面对 .NET Framework 3.5 的固定叫法不要写成 NetFx35 或者 NetFramework3.5名称一个字都不能错。/all连同该功能的父功能一起处理。NetFx3 在功能树里有上层节点漏掉/all有时候装完能启用但子组件不全跑老程序照样报错。/source:C:\sources\sxs告诉 DISM 载荷在哪里。注意路径必须指到 sxs 目录本身指到 ISO 根目录或者sources上一层都不行这是最常见的填错方式。/limitaccess禁止 DISM 在本地源不完整时回退去联系 Windows 更新。关于/limitaccess我要多说几句因为这是内网环境里最容易漏的参数。不写它的时候DISM 会先试本地源一旦发现缺了点什么就转身去问 Windows 更新而内网机器问不通于是它会一直等到超时最后抛出一个 0x800F0906让你误以为是本地源有问题。实际上本地源好好的坑就在这个回退行为上。2.3 PowerShell 版本的写法与功能名差异如果你更习惯 PowerShell等价命令是Install-WindowsFeature -Name NET-Framework-Core -Source C:\sources\sxs用之前先用下面这条把功能名确认一遍因为不同系统版本里这个功能的名字不一样Get-WindowsFeature *NET*在 Server 2012 和 2012 R2 上.NET 3.5 对应的功能名是NET-Framework-Core到了 Server 2016 及以后功能名变成了NET-Framework-Features它同时覆盖 3.5 和 4.x。名字写错的话PowerShell 会直接告诉你找不到该功能不会给你任何猜测的余地。还有一个差异值得注意Install-WindowsFeature的-Source参数在 Server 2012 上是有的但在更老的 Server 2008 R2 上对应的Add-WindowsFeature根本没有这个参数只能靠组策略里的LocalSourcePath或者修改注册表来指定源。如果你手上还混着 2008 R2 的机器这一点要单独记一下不要拿 2012 的命令去套。2.4 装完怎么确认别只看界面上的成功图形界面或者命令返回成功之后我习惯再验证三处确保功能真的落地了而不是清单层面打了个勾。第一处功能状态Get-WindowsFeature NET-Framework-CoreInstall State显示Installed才算数。第二处注册表标记reg query HKLM\SOFTWARE\Microsoft\NET Framework Setup\NDP\v3.5 /v Install返回0x1说明运行时层面的安装标记已经写入。第三处目录是否存在dir C:\Windows\Microsoft.NET\Framework\v3.5这个目录里有 csc.exe、mscorlib.dll 之类的核心文件才说明二进制真的进来了。最后拿一个实际用到 3.5 的程序跑一遍。最轻量的验证方式是在 PowerShell 里加载一个老版本才有的程序集比如Add-Type -AssemblyName System.Web能加载成功基本就没问题了。如果这台服务器上本来就跑着依赖 3.5 的业务程序直接把它拉起来看日志更直观。3. 内网 WSUS 环境指定了源为什么还是失败3.1 UseWUServer 是怎么把安装请求劫走的这是最让人困惑的一类故障源明明指定得没错路径也确认存在可还是报错。原因在于受 WSUS 管理的机器上Windows 更新客户端wuauserv 服务被策略改写成只连内网更新服务器而按需功能这类载荷在内网 WSUS 上通常没有同步或者根本没走 WSUS 的分发机制。系统在需要下载载荷时会去问更新客户端客户端回复我这儿没有于是报 0x800F0954 或者 0x800F0906。这个机制带来的一个直接结论是在内网环境里最可靠的永远是本地源不要去指望更新通道。很多人第一反应是去修 WSUS 服务器、往里面塞更新分类折腾半天发现这条路根本不通方向从一开始就选错了。正确的姿势是准备好 sxs 目录配上/limitaccess让系统彻底不去碰更新通道。3.2 万一确实需要走更新通道摘除的顺序别搞反有些场景下你确实没法准备本地源比如服务器在很远的机房手上只有这一台机器只能试试从更新通道拿。这时候需要临时把 WSUS 通道摘掉但顺序很重要直接改键不重启服务是不生效的。先把原值记下来别改完忘了改回去reg query HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU /v UseWUServer然后把值改成 0并且按顺序重启相关服务reg add HKLM\SOFTWARE\Policies\Microsoft\Windows\WindowsUpdate\AU /v UseWUServer /t REG_DWORD /d 0 /f net stop wuauserv net stop bits net start bits net start wuauserv注意是停 wuauserv 和 bits 两个服务先停 wuauserv 再停 bits启动时反过来先起 bits 再起 wuauserv。只重启其中一个策略有时候加载不进去这个细节在微软文档里也是这么写的但很多教程都略过去了。装完之后把值改回 1 并再重启一次服务否则这台机器就脱离内网补丁管理体系了后面合规检查会找你麻烦。3.3 组策略里那三项配置分别管什么路径是计算机配置 → 管理模板 → 系统 → 指定可选组件安装和组件修复的设置。这个策略展开后有三个关键项我见过太多人只勾了一半然后回来报错。第一项是策略总开关。设为已启用才会读取下面的配置设为未配置时系统走默认行为而默认行为在不同版本上还不一样很坑。第二项是联系 Windows 更新以获取修复内容。勾上系统就允许去 Windows 更新拉按需功能载荷不勾就只认本地源。内网机器上我一般不勾并且把备用源路径填好这样安装过程不会去等网络超时。第三项是从不安装来自 Windows 更新的更新这个在功能修复场景下容易被忽略。勾上它会彻底封死回退路径配合本地源用是合理的但如果你既没本地源又勾了它那就是自己把自己的路堵死了。对应的注册表键在HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing下面RepairContentServerSource这个 DWORD 值的含义是0 表示未配置1 表示不联系 Windows 更新2 表示联系 Windows 更新。LocalSourcePath是字符串类型填备用源路径。3.4 LocalSourcePath配一次后面所有机器都省事如果你管着一批同版本的服务器每台都手动喂源太累了。这时候把LocalSourcePath配到一个统一位置就行了。域环境里可以走组策略下发工作组的机器就在部署脚本里写注册表reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v LocalSourcePath /t REG_EXPAND_SZ /d D:\sources\sxs /f reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v RepairContentServerSource /t REG_DWORD /d 1 /f这里把RepairContentServerSource设成 1是因为内网完全隔离的环境里让系统去尝试联系 Windows 更新只会白白等超时不如直接告诉它只认本地源。配上这个之后添加角色和功能向导里勾 .NET 3.5 就能一路装完不用每次手动填路径。如果要指向网络共享比如\\fileserver\sources\sxs有一点必须注意访问共享的是计算机账户不是登录用户。共享权限和安全权限里都要把域计算机组加进去给读取权限否则会出现路径存在但 DISM 说访问不了的怪现象这个坑我踩过排查起来特别费劲因为用资源管理器手动访问是通的你会下意识觉得权限没问题。4. 手里没有带 sxs 的镜像怎么办4.1 从 install.wim 现场提取载荷有些企业定制镜像或者精简过的安装介质sources\sxs目录被删掉了ISO 拿到手发现里面只有 install.wim。这种情况下有两条路可以试。第一条是直接让 DISM 从 WIM 里取源。较新版本的 DISM 支持这种写法dism /online /enable-feature /featurename:NetFx3 /all /source:WIM:E:\sources\install.wim:2 /limitaccess冒号后面的数字是镜像索引先用下面这条命令确认一下目标镜像在第几号dism /Get-WindowsImage /ImageFile:E:\sources\install.wim需要提醒的是/Source:WIM:这个语法在不同版本的 DISM 上支持程度不一样Server 2012 原版自带的 DISM 6.2 未必认。如果执行时报参数错误别在这上面死磕换第二条路。第二条是把 WIM 挂载起来从挂载后的目录里找载荷dism /Mount-Wim /WimFile:E:\sources\install.wim /Index:2 /MountDir:C:\wimmount /ReadOnly挂载完成后到C:\wimmount\Windows\WinSxS下面翻。但说实话WinSxS 里的文件是硬链接形态直接拷贝出来经常不能用所以这条路更多是给你确认文件确实在而不是当作可用的源。用完记得卸载不然挂载目录会一直被占用dism /Unmount-Wim /MountDir:C:\wimmount /Discard4.2 从同版本同语言的机器上取源另一个思路是在手边找一台已经装好 .NET 3.5、版本和语言都一致的 Server 2012把它的安装介质里的 sxs 拿过来用。注意这里说的是介质里的 sxs不是从系统盘里抠文件系统盘里的 WinSxS 不适合直接当源。如果实在找不到原始介质可以考虑用官方的批量授权渠道重新下载一份对应版本的 ISO这是最省心的做法。网上流传的各种sxs 压缩包NetFx3 离线包来源不明的我一般不碰因为按需功能载荷和系统版本严格绑定装错了轻则报错重则把组件存储搞坏后面要花更多时间修。真要用第三方整理的包至少先核一下文件版本号和数字签名。4.3 版本号和语言这两个条件必须同时满足这是非常硬性的一条规则sxs 载荷的版本和语言必须与目标系统完全一致。版本层面Server 2012 是 6.2 分支Server 2012 R2 是 6.3 分支两者的 sxs 不能互换。拿 2012 R2 的介质去给 2012 装DISM 通常会直接报源不匹配偶尔有能装进去的后续也会出各种诡异问题。语言层面中文版系统配英文版 sxs大部分情况装不上少数能装上的也会在运行老程序时因为资源文件缺失而报错。判断语言版本看 ISO 文件名里的cn或者en标识最直接系统侧可以用下面这条确认dism /online /get-intl会输出系统当前的区域和语言设置。先确认这两项对得上再去准备源能省掉大量无效尝试。5. 那些年我在这个报错上踩过的具体坑5.1 路径里有空格却忘了加引号看起来是低级错误但真的高频。如果 sxs 目录放在D:\My Files\sources\sxs这种带空格的路径下命令必须写成dism /online /enable-feature /featurename:NetFx3 /all /source:D:\My Files\sources\sxs /limitaccess不加引号的话DISM 会把路径在空格处截断然后告诉你找不到源文件。你去看那个截断后的路径发现确实不存在但如果不去细想很容易得出sxs 目录有问题的错误结论。我现在干脆把源统一放在C:\sources\sxs这种绝对没有空格的路径下从根本上避免这个问题。5.2 /LimitAccess 漏写导致白等十几分钟前面提过一次这里再强调因为它浪费的时间成本太高。内网机器上只写/source不写/limitaccessDISM 会先读本地源发现内容不完全匹配就回退到 Windows 更新然后在内网里一路超时整个过程可能持续十几分钟最后抛一个 0x800F0906。你看着这个错误码以为是源的问题换了几个源反复试其实是参数没写全。我的习惯是把这条命令做成一个固定脚本参数写死谁需要谁拿去跑避免每个人凭记忆敲命令漏参数。5.3 半途中断留下的组件状态怎么收拾安装过程中断电、强制重启或者手滑关掉向导都会留下一个挂起的功能状态之后再装会提示有操作未完成。先检查一下reg query HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending如果有输出最简单的处理方式是重启一次让挂起操作落地然后再重新执行安装命令。如果重启之后还是不行可以看一眼 CBS 日志里的具体错误Select-String -Path C:\Windows\Logs\CBS\CBS.log -Pattern NetFx3 | Select-Object -Last 30这里要特别区分一个容易混淆的点/RestoreHealth用的源和 NetFx3 用的源不是同一个东西。下面这条命令看着像那么回事其实源的类型不对dism /online /cleanup-image /restorehealth /source:C:\sources\sxs /limitaccessRestoreHealth需要的是完整的组件存储镜像通常来自同版本机器的C:\Windows\WinSxS或者挂载后的 install.wim 目录而不是sources\sxs。拿 sxs 去喂 RestoreHealth大概率报源无效。这两件事在论坛上经常被写混照着抄很容易走进死胡同。5.4 图形界面向导里那个源路径框填什么带桌面体验的版本可以用添加角色和功能向导走到最后一步会出现一个指定备用源路径的输入框。这里填的必须是sxs 目录本身也就是E:\sources\sxs而不是 ISO 根目录E:\也不是E:\sources。填错的表现通常是向导跑一会儿然后失败报的还是找不到源文件。因为界面上没有明确提示它期望的是哪个层级很多人会下意识填盘符根目录。我的建议是能用命令行就用命令行路径填错会立刻报错比向导跑一遍再失败要省时间。5.5 Server Core 上的操作差异Server Core 没有图形界面添加角色和功能向导根本打不开只能靠 DISM 或者 PowerShell 的Install-WindowsFeature。命令本身和前面写的一样但要留意 Server Core 上默认没有 .NET 3.5 相关的任何图形依赖装完之后如果要跑 .NET 2.0/3.5 编译的老程序记得确认对应的 32 位子系统支持也正常因为很多老业务程序是 32 位的走的是 WOW64 通道。6. 同一套思路在 Windows 10 和 11 上照样管用6.1 机制没变变的只是路径和功能名桌面版 Windows 从 8 开始用的也是同一套按需功能机制所以 Windows 10、Windows 11 上装 .NET 3.5 报的错、报错码、处理思路几乎一模一样。命令还是那一条dism /online /enable-feature /featurename:NetFx3 /all /source:D:\sources\sxs /limitaccess把 D 换成挂载后的 ISO 盘符就行。区别在于 Windows 10/11 的安装 ISO 里sources\sxs同样存在但体积比服务器版小一些因为它只带 NetFx3 相关的载荷。需要额外注意的是Windows 11 上通过设置 → 应用 → 可选功能去添加 .NET 3.5 时系统默认会去 Windows 更新拉载荷离线环境下必然失败而且界面上给的提示非常模糊只说安装失败不给具体错误码。这种情况直接绕开图形界面用 DISM 命令行指定本地源比在设置里反复点要高效。6.2 离线 cab 包什么时候能用微软官方确实提供过按需功能包Features on Demand里面有针对 NetFx3 的 cab 文件可以用下面这种方式安装dism /online /add-package /packagepath:D:\FoD\Microsoft-Windows-NetFx3-OnDemand-Package~31bf3856ad364e35~amd64~~.cab这个做法在 Windows 10 的部分版本上是可行的但有一条硬性约束cab 包的版本必须和系统内部版本号严格对应。比如 22H2 的包只能喂给 22H2 的系统跨版本装基本都会失败。至于预览版通道的系统对应的 FoD 包往往拿不到这种时候还是回到最原始的办法——用对应版本的 ISO 里的 sxs 目录。所以我的排序是优先本地 ISO 的 sxs其次才考虑 FoD 包。前者几乎不会出错后者要核对版本多一道工序。6.3 把源目录写进装机模板如果你经常批量装机有个一劳永逸的做法在系统部署脚本里就把源目录和注册表项准备好。比如在镜像里预留一个D:\sources\sxs把对应版本的 sxs 目录塞进去然后在首次启动脚本里写两条注册表reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v LocalSourcePath /t REG_EXPAND_SZ /d D:\sources\sxs /f reg add HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Policies\Servicing /v RepairContentServerSource /t REG_DWORD /d 1 /f这么配完之后后续不管是装 .NET 3.5、开 IIS 的某些组件还是触发组件修复系统都会自动从本地目录取文件不用再有人记得去挂 ISO。这套做法我在几个交付项目里用过效果比事后补救好得多尤其是当装机的人和用机的人不是同一批的时候。要注意的是sxs 目录会占用几百兆到一两个 G 的空间如果磁盘紧张可以只在装机阶段临时放装完之后清理掉但注册表里的LocalSourcePath记得要么删掉要么改到有效路径否则以后组件修复时会因为找不到源而报一堆错。我个人在实际操作中的体会是.NET 3.5 装不上这件事麻烦从来不在技术难度而在于信息不全——你不知道系统去哪找、找了什么、为什么没找到。把三条诊断命令跑一遍确认是本地源缺失还是更新通道被接管然后对症下药多数情况十分钟内就能解决。真正耗时间的永远是那些凭着印象敲命令、漏了关键参数还不自知的时刻所以我现在宁可多花两分钟把参数对着文档核一遍也不愿意事后翻半小时日志。最后再分享一个小技巧把那条完整的 DISM 安装命令连同注释存成一个.bat放到服务器的工具目录里下次遇到同类问题直接双击比现查资料快得多也能避免手抖漏参数。
