VM重启后Self Hosted Agent服务启动失败排查求助

架构老林

2026-6-27

调试Azure Pipelines自托管Agent重启启动失败（错误码217/USER）

错误码217/USER明确指向systemd无法找到服务配置中指定的运行用户，以下是针对性的调试步骤：

检查systemd服务文件的用户配置
执行命令查看服务文件内容：
```
cat /etc/systemd/system/vsts.agent.MyOrg.Ppe\x2dItem\x2dPrice\x2dAgent\x2dPool.pc1231bg1111.service
```
重点确认[Service]段中的User=字段值是否为OrgDomain+svc-Itemsrvce，注意格式是否符合系统对域用户的要求（部分环境下域用户需用DOMAIN\username或username@domain.com格式）。
验证目标用户的有效性
- 执行id OrgDomain+svc-Itemsrvce，若返回用户不存在的错误，说明该用户标识符在系统中不被识别，需替换为正确的用户格式。
- 尝试切换到该用户：su - OrgDomain+svc-Itemsrvce，若无法登录，说明用户未在系统中正确配置或不存在。
手动测试Agent启动脚本
模拟systemd的执行环境，手动运行启动脚本：
```
su - OrgDomain+svc-Itemsrvce -c "/home/OrgDomain+svc-Itemsrvce/myagent/runsvc.sh"
```
观察是否有报错信息；同时查看Agent目录下的诊断日志获取详细错误：
```
cat /home/OrgDomain+svc-Itemsrvce/myagent/_diag/*.log
```
重新生成systemd服务文件
若服务文件存在路径转义或配置错误，先卸载现有服务：
```
sudo ./svc.sh stop && sudo ./svc.sh uninstall
```
然后重新指定正确用户安装服务：
```
sudo ./svc.sh install OrgDomain+svc-Itemsrvce
```
确保域服务就绪后再启动Agent
若使用域用户，系统重启时Agent可能在域认证服务启动前尝试运行，导致无法识别用户。修改服务文件，在[Unit]段添加依赖：
```
After=sssd.service
```
然后重新加载systemd配置并重启服务：
```
sudo systemctl daemon-reload
sudo systemctl restart vsts.agent.MyOrg.Ppe\x2dItem\x2dPrice\x2dAgent\x2dPool.pc1231bg1111.service
```