使用win32serviceutil创建自定义Windows服务启动失败问题排查

针对你用pywin32开发Windows监控服务遇到的启动问题，直接给出落地排查和解决步骤：

一、Error 1053核心排查点 #

1. 服务启动超时问题（最常见原因） #

Windows要求服务的OnStart方法必须在30秒内返回，如果你的OnStart里直接执行了文件夹监控的阻塞逻辑，必然触发超时。必须把监控逻辑放到独立线程中，示例代码如下：

import threading
import win32serviceutil
import win32service

class CloudService(win32serviceutil.ServiceFramework):
    _svc_name_ = "FolderMonitorService"
    _svc_display_name_ = "文件夹监控服务"
    _svc_description_ = "监控文件夹变更并记录到桌面日志"

    def __init__(self, args):
        win32serviceutil.ServiceFramework.__init__(self, args)
        self.stop_event = threading.Event()
        self.monitor_thread = None

    def OnStart(self):
        # OnStart只负责启动线程，立即返回
        self.monitor_thread = threading.Thread(target=self.run_monitor)
        self.monitor_thread.start()

    def run_monitor(self):
        # 这里放你的MyHandler监控逻辑
        handler = MyHandler()
        # 监控循环要监听停止信号，方便服务正常退出
        while not self.stop_event.is_set():
            handler.monitor()  # 替换为你的监控执行方法

    def OnStop(self):
        self.stop_event.set()
        if self.monitor_thread:
            self.monitor_thread.join()

2. 路径与权限问题 #

• 绝对路径替代相对路径：服务默认工作目录是C:\Windows\System32，直接写Desktop\log.txt会找不到路径，必须用绝对路径获取桌面：

  import os
  from win32com.shell import shell, shellcon
  desktop_path = shell.SHGetFolderPath(0, shellcon.CSIDL_DESKTOP, None, 0)
  log_path = os.path.join(desktop_path, "monitor_log.txt")
  

• 权限检查：默认Local System账户可能对部分路径无写入权限，可先将日志写到C:\ProgramData目录测试，或在服务属性的「登录」选项卡，切换为有管理员权限的本地账户。

3. 环境依赖问题 #

脚本直接作为服务运行时，可能找不到Python环境或依赖库。解决方式：
用pyinstaller将脚本打包为独立exe：

pyinstaller --onefile --noconsole CloudService.py

然后用管理员终端执行CloudService.exe install安装服务，打包后的exe会包含所有依赖，避免环境缺失问题。

4. 错误日志定位 #

在OnStart中加入异常捕获日志，直接定位启动失败的具体原因：

from datetime import datetime

def OnStart(self):
    try:
        with open(log_path, "a", encoding="utf-8") as f:
            f.write(f"服务启动：{datetime.now()}\n")
        self.monitor_thread = threading.Thread(target=self.run_monitor)
        self.monitor_thread.start()
    except Exception as e:
        with open(log_path, "a", encoding="utf-8") as f:
            f.write(f"启动失败：{str(e)}\n")
        raise  # 抛出异常让Windows捕获，便于排查

二、Error 2（找不到指定文件）解决 #

该错误多为服务安装时路径不完整导致，解决方式：

• 安装服务时使用脚本的绝对路径：

  python "C:\你的完整路径\CloudService.py" install
  

• 优先使用打包后的exe安装服务，避免Python路径依赖问题。

三、服务重置自动化脚本 #

测试时可自动删除旧服务并重建：

import win32serviceutil
import win32service

SERVICE_NAME = "FolderMonitorService"
SCRIPT_PATH = "C:\你的完整路径\CloudService.py"

# 停止并删除旧服务
try:
    win32serviceutil.StopService(SERVICE_NAME)
except win32service.error:
    pass
try:
    win32serviceutil.RemoveService(SERVICE_NAME)
except win32service.error:
    pass

# 安装并启动新服务
win32serviceutil.InstallService(
    SCRIPT_PATH,
    SERVICE_NAME,
    SERVICE_NAME,
    displayName="文件夹监控服务",
    description="监控文件夹变更并记录日志"
)
win32serviceutil.StartService(SERVICE_NAME)

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