使用pywin32创建Windows服务时导入第三方包启动失败问题

问题背景 #

使用pywin32搭建Windows服务时，基础测试服务可正常安装运行，但添加第三方依赖（如import numpy as np）后，服务安装成功但启动失败。调试模式（python service.py debug）下运行一切正常，已尝试以下操作未解决：

• 未使用虚拟环境，脚本与Python安装均在C盘
• 已将Python39\Lib\site-packages\pywin32_system32中的.dll文件复制到Python39\Lib\site-packages\win32
• 检查系统环境变量未发现异常

测试脚本如下：

import win32serviceutil
import win32service
import win32event
import servicemanager
import socket

class AppServerSvc (win32serviceutil.ServiceFramework):
    _svc_name_ = "TestService"
    _svc_display_name_ = "Test Service"

    def __init__(self,args):
        win32serviceutil.ServiceFramework.__init__(self,args)
        self.hWaitStop = win32event.CreateEvent(None,0,0,None)
        socket.setdefaulttimeout(60)

    def SvcStop(self):
        self.ReportServiceStatus(win32service.SERVICE_STOP_PENDING)
        win32event.SetEvent(self.hWaitStop)

    def SvcDoRun(self):
        servicemanager.LogMsg(servicemanager.EVENTLOG_INFORMATION_TYPE,
                              servicemanager.PYS_SERVICE_STARTED,
                              (self._svc_name_,''))
        self.main()

    def main(self):
        pass

if __name__ == '__main__':
    win32serviceutil.HandleCommandLine(AppServerSvc)

可行解决方案 #

1. 手动注入Python包路径 #

Windows服务运行的环境与用户登录环境隔离，即使全局环境变量配置正确，服务进程可能无法识别第三方包路径。在脚本开头添加以下代码，手动将site-packages路径加入sys.path：

import sys
import os

# 替换为你的Python版本对应的site-packages绝对路径
site_packages = r"C:\Python39\Lib\site-packages"
if site_packages not in sys.path:
    sys.path.insert(0, site_packages)

确保这段代码在所有第三方依赖导入之前执行。

2. 用绝对路径安装并指定Python解释器 #

安装服务时，明确使用Python解释器的绝对路径，避免服务调用错误的Python环境：

C:\Python39\python.exe service.py install

启动服务前，确认服务的登录账户（建议使用Local System）拥有Python安装目录及依赖包目录的读取、执行权限。

3. 验证依赖包架构与权限 #

• 检查numpy等依赖包的版本是否与Python（32/64位）完全匹配，架构不匹配会直接导致启动失败。
• 右键Python安装目录及site-packages文件夹，选择「属性」→「安全」，确保服务运行账户（如Local System）拥有读取和执行权限。

4. 添加错误日志捕获 #

在main方法中添加异常捕获，将错误信息写入本地日志，方便定位具体问题：

def main(self):
    try:
        import numpy as np
        # 你的业务逻辑代码
    except Exception as e:
        with open(r"C:\service_start_error.log", "a", encoding="utf-8") as f:
            f.write(f"启动异常: {str(e)}\n")
        # 抛出异常让服务管理器记录错误
        raise

5. 重新注册pywin32组件 #

pywin32的服务注册可能存在不完整情况，重新运行注册命令：

C:\Python39\Scripts\pywin32_postinstall.py -install

该命令会重新注册pywin32相关的服务组件与DLL文件，确保服务运行时能正确加载依赖。

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