Windows Server 2019环境下通过Apache CGI调用pyttsx3生成空WAV文件的故障排查求助

我之前碰到过几乎一模一样的情况，这本质上是服务运行身份缺少语音合成所需的系统权限和组件注册权限导致的。结合你已经排查到的注册表权限和COM错误，给你几个针对性的解决步骤：

1. 补全语音合成相关的注册表与目录权限 #

除了你已经设置的注册表项，还需要补充以下权限配置：

• 给IUSR（或Apache实际运行的账户）分配HKLM\Software\Microsoft\Speech_OneCore\Voices和HKLM\Software\Wow6432Node\Microsoft\Speech（如果你的Python是32位版本）的读取+查询权限（完全控制没必要，读取权限足够）。
• 给IUSR分配C:\Windows\System32\Speech_OneCore目录的读取权限，这里是系统语音包的核心存储位置。

2. 切换Apache服务的运行账户为本地系统账户 #

默认的IUSR或Network Service账户缺少桌面交互权限，而SAPI5的语音合成在服务器环境下需要依赖桌面会话的支持：

• 打开Windows服务管理器，找到Apache服务 → 右键属性 → 「登录」选项卡 → 选择「本地系统账户」，并勾选「允许服务与桌面交互」。
• 重启Apache服务后测试脚本，这一步大概率能解决权限不足导致的音频生成失败问题。（如果担心安全，后续可以再调整到更受限的账户，但先验证是否解决问题）

3. 重新注册SAPI5相关COM组件 #

针对你遇到的「Class not registered」错误，以管理员身份打开命令提示符，运行以下命令重新注册核心组件：

regsvr32 "C:\Windows\System32\sapi.dll"
regsvr32 "C:\Windows\Wow6432Node\sapi.dll"
regsvr32 "C:\Windows\System32\Speech_OneCore\Common\sapi_onecore.dll"

这一步能修复服务账户无法读取未正确注册的COM组件的问题。

4. 给pyttsx3指定具体的语音引擎 #

有时候服务账户找不到默认语音，你可以先在命令行运行以下代码获取可用的语音ID：

import pyttsx3
engine = pyttsx3.init("sapi5")
voices = engine.getProperty('voices')
for voice in voices:
    print(voice.id)

然后在CGI脚本中指定具体的语音ID，比如：

engine = pyttsx3.init("sapi5")
# 替换成你实际获取到的语音ID
engine.setProperty('voice', 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Speech\Voices\Tokens\TTS_MS_EN-US_ZIRA_11.0')

5. 检查临时文件目录权限 #

pyttsx3生成音频时会用到临时文件，默认临时目录是C:\Windows\Temp，确保IUSR对这个目录有读写权限。或者在脚本中指定一个你有权限的临时目录：

import tempfile
tempfile.tempdir = "C:\path\to\your\custom\temp\folder"

每完成一步就重启Apache并测试脚本，一般按这个流程下来就能解决问题——毕竟Windows 10上正常是因为WAMP默认用的权限更高的账户，而服务器环境的服务账户权限限制更严格，这些步骤就是针对性补全缺失的权限和组件支持。

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