Go 编写的 Windows 服务在启动时默认工作目录为 C:\Windows\System32，而非可执行文件所在目录，导致 Viper 等配置库无法定位 config.json，引发服务超时失败。解决方案是显式获取并切换到程序主目录。
go 编写的 windows 服务在启动时默认工作目录为 `c:\windows\system32`，而非可执行文件所在目录，导致 viper 等配置库无法定位 `config.json`，引发服务超时失败。解决方案是显式获取并切换到程序主目录。
在使用 golang.org/x/sys/windows/svc 开发 Windows 服务时，一个常见却容易被忽视的问题是：服务进程的当前工作目录（os.Getwd()）并非可执行文件所在路径，而是系统服务宿主目录（通常是 C:\Windows\System32）。这意味着，若你在 init() 或服务 Execute() 方法中直接调用 viper.SetConfigFile("config.json") 或 viper.ReadInConfig()，Viper 将在 System32 下查找配置文件，自然失败——服务因此无法在规定时间内完成初始化，最终触发 Windows 的“服务未及时响应”错误（ERROR_SERVICE_REQUEST_TIMEOUT）。
✅ 正确做法是：在服务启动早期（如 Execute() 开头或 init() 后首次调用处），主动定位可执行文件所在目录，并将工作目录切换至此，或直接基于该路径构造配置文件绝对路径。
推荐使用 github.com/kardianos/osext（注意：该库已归档，但功能稳定且广泛兼容；Go 1.16+ 用户亦可选用标准库 os.Executable() 配合 filepath.Dir() 实现同等效果）：
package main
import (
"log"
"path/filepath"
"github.com/spf13/viper"
"golang.org/x/sys/windows/svc"
"golang.org/x/sys/windows/svc/debug"
"golang.org/x/sys/windows/svc/service"
// 替代方案（Go 1.16+，无需第三方）：
// "os"
// "os/exec"
// "filepath"
)
func initConfig() {
// ✅ 获取可执行文件所在目录（推荐：兼容旧版 Go）
exePath, err := filepath.Abs(filepath.Dir(os.Args[0]))
if err != nil {
log.Fatalf("failed to resolve executable directory: %v", err)
}
// ✅ 切换工作目录（可选，但最直观）
if err := os.Chdir(exePath); err != nil {
log.Fatalf("failed to change working directory to %s: %v", exePath, err)
}
// 或者更安全的方式：不改 cwd，直接指定配置路径
viper.SetConfigFile(filepath.Join(exePath, "config.json"))
viper.SetConfigType("json")
if err := viper.ReadInConfig(); err != nil {
log.Fatalf("failed to read config file: %v", err)
}
}
type myService struct{}
func (m *myService) Execute(args []string, r <-chan svc.ChangeRequest, changes chan<- svc.Status) (bool, uint32) {
// ⚠️ 关键：必须在处理任何配置或业务逻辑前调用
initConfig()
// 设置服务状态为运行中
changes <- svc.Status{State: svc.Running, Accepts: svc.AcceptStop | svc.AcceptShutdown}
// 模拟主循环（实际中应监听信号或启动 HTTP server 等）
select {
case <-r:
return false, 0
}
}
func runService(isInteractive bool) {
var err error
if isInteractive {
err = debug.Run("MyGoService", &myService{})
} else {
err = service.Run("MyGoService", &myService{})
}
if err != nil {
log.Fatal(err)
}
}
func main() {
isInteractive, err := svc.IsAnInteractiveSession()
if err != nil {
log.Fatal(err)
}
runService(isInteractive)
}? 重要注意事项：
- ❌ 不要在 init() 函数中调用 os.Getwd() 或 viper.ReadInConfig() —— 此时服务尚未启动，工作目录不可靠；
- ✅ 所有路径解析与配置加载必须在 Execute() 方法内、首次处理 svc.ChangeRequest 前完成；
- ? 若服务以 LocalSystem 账户运行，请确保 config.json 文件具有对应读取权限（避免因权限问题静默失败）；
- ? 开发调试阶段，建议始终启用 debug.Run() 模式验证路径逻辑，它会在当前终端运行服务，便于打印日志和观察 os.Getwd() 实际值；
- ? 对于新项目，优先使用标准库替代 osext：
exePath, err := os.Executable() if err != nil { panic(err) } dir := filepath.Dir(exePath) // 即可执行文件所在目录
通过显式定位可执行文件路径并据此加载配置，即可彻底解决 Windows 服务启动超时问题，确保 Go 服务在生产环境中稳定、可靠地运行。
