Windows服务中基于SFL框架初始化Python报错的解决求助

基于SFL（Service Framework Library）开发Windows服务，控制台运行正常，但通过sc start MyService启动服务时，调用Py_Initialize触发致命错误：

Fatal Python error: failed to get the Python codec of the filesystem encoding

sc query MyService输出：

SERVICE_NAME: MyService 
TYPE : 10
WIN32_OWN_PROCESS STATE : 1
STOPPED WIN32_EXIT_CODE : 1077 (0x435)
SERVICE_EXIT_CODE : 0 (0x0)
CHECKPOINT : 0x0
WAIT_HINT : 0x0

核心代码片段：

#include "SflBase.h"
namespace nsSFL                                                                             
{                                                                                           
    const CMyService* SflGetServiceApp(void)                                                         
    {                                                                                       
        static T theApp;                                                                     
        return &theApp;                                                                      
    }                                                                                       
}                                                                                           
int _tmain( int argc, LPTSTR* argv )                                                          
{            
    CMyService* pApp = const_cast<CMyService*>( SFL_NS SflGetServiceApp() );                                  
    nsSFL::CServiceRoot* pServiceMap[] = {                                                    
       nsSFL::CServiceProxyT<CMyService, 0>::Construct2((TService*)NULL, L"CMyService")                                                                           
    };                                                                                      
    int retMain = -1;
    if(pApp->PreMain(argc, argv))
        retMain = pApp->Main( argc, argv, pServiceMap, ARRAYSIZE(pServiceMap));
    pApp->PostMain();
    return retMain;
}
BOOL CMyService::PreMain(int argc, LPTSTR* argv)
{   
    if (!InitInstance(argc, argv))
    {
        return FALSE;
    }
    return TRUE;
}
BOOL CMyService::InitInstance(DWORD argc, LPTSTR* lpszArgv)
{
    if (!AfxWinInit(::GetModuleHandle(nullptr), nullptr, ::GetCommandLine(), 0))
    {
        return FALSE;
    }
    {
        PyPreConfig preconfig;
        PyPreConfig_InitIsolatedConfig(&preconfig);
        preconfig.utf8_mode = true;

        status = Py_PreInitialize(&preconfig);
        pystatus_exit_on_error(status);
    }

    // auto pythonPath = L"%localappdata%\\Programs\\Python\\Python38\\python.exe";
    auto pythonPath = L"C:\\Program Files\\Python38\\python.exe";
    Py_SetPythonHome(pythonPath);
    Py_Initialize(); // print "Fatal Python error" only then work as service
}

项目配置：C++20，Windows SDK 10.0.20348.0，Visual Studio 2022（v143），Python 3.8（x64），Boost 1.77。

已尝试的解决方案：调整/取消PYTHONPATH、PYTHONHOME环境变量，修改Py_SetPythonHome路径，使用PyConfig_InitIsolatedConfig，均无效。怀疑与LocalSystem权限限制有关，但NetworkService无法启动服务，LocalService不满足端口操作需求，不知如何配置权限或排查问题。

1. 修正Py_SetPythonHome的路径 #

你当前传递给Py_SetPythonHome的是Python可执行文件路径（python.exe），但该函数要求传入Python的安装根目录，而非exe路径。修改代码：

// 错误路径：带python.exe
// auto pythonPath = L"C:\\Program Files\\Python38\\python.exe";
// 正确路径：Python安装根目录
auto pythonPath = L"C:\\Program Files\\Python38";
Py_SetPythonHome(pythonPath);

Python需要从根目录找到Lib、DLLs等子目录加载编码模块，这是触发编码错误的核心原因之一。

2. 确保服务账户有Python目录的读取权限 #

LocalSystem账户虽权限高，但需确认：

• 给C:\Program Files\Python38目录添加LocalSystem账户的读取和执行权限
• 重点保证Lib\encodings子目录可访问，这是Python加载文件系统编码的关键目录

3. 调整Python初始化配置 #

你使用了PyPreConfig_InitIsolatedConfig，会让Python完全忽略系统环境变量，可尝试两种调整：

方案A：使用非隔离初始化 #

若不需要隔离环境，改用默认配置：

PyPreConfig preconfig;
PyPreConfig_InitPythonConfig(&preconfig); // 替换为默认初始化
preconfig.utf8_mode = true;

status = Py_PreInitialize(&preconfig);
pystatus_exit_on_error(status);

方案B：隔离模式下手动设置模块路径 #

若必须用隔离模式，手动添加Python的Lib路径：

// 在Py_Initialize之前添加
wchar_t libPath[MAX_PATH];
swprintf_s(libPath, L"%s\\Lib", pythonPath);
Py_SetPath(libPath);

4. 调试服务获取详细错误信息 #

服务环境无控制台输出，建议添加日志：

• 在Py_Initialize前，用WriteEventLog或自定义日志文件记录当前环境变量（如PYTHONHOME、PATH）
• 使用PyErr_WriteUnraisable(NULL)捕获Python初始化的详细错误并写入日志

也可附加调试器到服务：

1. 在InitInstance开头添加DebugBreak()
2. 启动服务后，在Visual Studio中选择调试->附加到进程，找到服务进程
3. 触发断点后查看调用栈和错误详情

5. 服务权限配置建议 #

若LocalSystem权限有问题，且NetworkService/LocalService不满足需求：

• 创建自定义本地账户，赋予该账户：
  • 端口操作所需权限（如SeNetworkServiceLogonRight、SeCreateGlobalPrivilege等，按需调整）
  • Python目录的读取权限
  • 服务运行权限（在服务属性中选择该账户登录）
• 使用命令配置服务账户：sc config MyService obj= "DOMAIN\Username" password= "Password"

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