TeamCity Agent启动失败：Windows Server 2022报Error 1067错误

1. 优先查看Agent日志定位根源 #

直奔Agent安装目录下的logs文件夹，重点看wrapper.log和teamcity-agent.log——这两个日志会直白记录进程终止的具体原因，比如JRE路径错误、权限不足、配置文件格式错误等，比系统提示的1067有用得多。

2. 验证JRE版本与配置 #

• 确认JRE版本和TeamCity Server兼容：比如Server用Java 11，Agent就不能用Java 17，版本不匹配大概率会崩。命令行跑java -version就能看当前版本。
• 检查TEAMCITY_JRE环境变量：确保路径是JRE根目录（比如C:\Program Files\Java\jre11.0.20），不是bin文件夹或者java.exe。设置后最好重启服务器让变量生效，别光重开命令行。

3. 核对Agent核心配置 #

打开conf\buildAgent.properties文件，检查几个关键项：

• serverUrl：必须是TeamCity Server的正确地址（比如http://192.168.1.100:8111），别写错端口或者域名
• workDir、tempDir、systemDir：这些路径要存在，且服务账户对它们有读写权限
• Agent名称name：别带特殊字符（比如@、#），容易触发解析错误

4. 修复Wrapper服务配置 #

Agent是通过Wrapper启动的，conf\wrapper.conf出问题也会导致1067：

• 检查wrapper.java.command：确保指向正确的java.exe路径（比如C:\Program Files\Java\jre11.0.20\bin\java.exe），如果用环境变量就写%TEAMCITY_JRE%\bin\java.exe
• 确认wrapper.java.classpath里的所有jar包路径都存在，没有缺失或路径错误

5. 彻底排查权限问题 #

别光换账户，要确认：

• 服务账户对Agent安装目录、工作/临时/系统目录有完全控制权限，不是只读或写入
• 如果用域账户，确保账户允许本地登录，临时加进本地管理员组测试（排除权限限制）
• 测试账户能不能访问TeamCity Server的8111端口，比如用浏览器打开Server地址，看能不能正常访问

6. 重新注册Agent服务 #

如果以上都没用，试试重置服务：

1. 以管理员身份打开命令提示符
2. 进入Agent安装目录的bin文件夹
3. 执行service.uninstall.bat卸载现有服务
4. 执行service.install.bat重新注册服务
5. 启动服务，观察是否正常

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