Azure DevOps Server 2019报Internal Server Error故障如何排查修复

1. 修复站点集合显示目录结构问题 #

该问题由IIS默认文档配置缺失导致，操作步骤如下：

• 打开IIS管理器，定位到Azure DevOps对应站点集合的站点节点，双击「默认文档」功能
• 检查列表是否存在default.aspx、index.aspx两类DevOps默认入口，缺失则手动添加，并调整优先级到列表首位
• 重启对应站点后刷新访问，确认目录结构问题是否解决

2. 开启详细报错捕获，定位500错误根因 #

默认配置下DevOps会隐藏详细报错信息，导致日志无有效线索，按如下步骤开启：

• 进入DevOps站点的根目录，找到web.config文件，修改前先做好备份
• 找到system.web节点，修改配置为<customErrors mode="Off" />，同时新增<deployment retail="false" />配置
• 找到system.webServer节点，修改httpErrors属性为<httpErrors errorMode="Detailed" existingResponse="PassThrough" />
• 重新触发「修改组权限」「安全管理」操作，此时页面会输出完整报错栈，可直接定位具体错误原因

3. 常见安全操作类500错误修复方案 #

这类报错90%以上是服务账户权限配置异常导致，优先做如下检查：

• 数据库权限检查：确认DevOps服务运行账户、IIS对应应用池运行账户，对DevOps配置数据库、所有站点集合数据库，至少拥有db_datawriter、db_datareader和存储过程执行权限，建议直接分配db_owner权限
• 本地权限检查：打开本地安全策略控制台（运行secpol.msc），确认上述两个账户拥有「本地登录」「作为服务登录」「调整进程内存配额」「生成安全审核」四项基础权限
• 账户令牌修复：打开Azure DevOps管理控制台，进入「应用层」节点，点击「更新服务账户密码」，即使密码未变更也重新走一遍校验流程，修复可能存在的账户身份令牌失效问题

4. 残留配置问题修复 #

如果上述操作都未解决，执行如下修复操作：

• 停止所有DevOps相关服务，打开命令行进入DevOps安装目录下的Tools文件夹，执行TfsConfig repair /install命令
• 检查对应应用池配置：确认运行时版本为.NET Framework v4.0.30319，托管管道模式为「集成」
• 操作完成后重启服务器，再验证所有功能是否正常

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