异常:无效的类字符串
(Invalid Class String)
。
使用python
操作COM
组件的朋友应该都碰到过,这个报错来自于python
标准库pythoncom
。win32com
也是建立在pythoncom
基础上的,在我使用win32com
一年多的期间,印象中碰到三次这个报错。有时候各种办法都尝试了,也无法解决,最后不得已重装了系统,虽然有点为了抓只老鼠把家给拆了的感觉,但最后也能解决了问题。
好死不死,昨天(2024年1月17日),我又碰到了这个问题,第四次了!,下面是业务场景:
线上测试时,有一台机器报错,同时本地开发环境也报同样的错:无效的类字符串
。每台下游机器均在子进程中运行win32com
,并不在主进程中。(是不是和进程有关呢?按下不表)。接下来,就逐步分析,彻底把把这只老鼠给揪出来消灭掉。
win32com
是如何工作的
弄清楚这个问题,一切就好办了。我们直接以win32com
的客户端启动器Dispatch
或DispatchEx
来举例,下面是一个简单的示例:
python
from win32com.client import Dispatch
client = Dispatch('kwps.application')
无效的类字符串
的错误在Dispatch('kwps.application')
这一步就会出现。
为何实参kwps.application
就能启动wps
客户端、word.application
能启动ms word
客户端,而visio.application
能启动Visio
呢。简单粗暴地说:使用不同的实参,就能启动不同的客户端。
实参是什么,实际上是由程序在windows注册表中的程序ID(ProgId
)决定的,看图:
在注册表中搜索关键词wps
就能看到红框中所示的KWPS.Application
的程序ID,这是一种身份标识,是唯一的。Dispatch('kwps.application')
凭借实参,通过pythoncom
来实现在注册表中查找与之匹配的应用程序。同样的,如果你安装了ms office
,你通过word
也能查到相关的程序ID。注意,Dispatch
入参不区分大小写。
跑题:你是否也看到了截图中红框下方有
KWPS.Document
,那么,是不是也可以Dispatch('kwps.document')
,它会启动一个什么呢?我已经试过了,并且瞬间就找到了一个为下游机器节省开销的方法。有好奇心的你不妨也尝试下。
分析
有了上面的理解作为基础,再来分析报错的原因。
情况一
错误的程序ID
当我使用Dispatch('wps.application')
时(注意,入参少了个k
),就会报错:无效的类字符串
,因为COM
组件无法通过wps.application
匹配到应用程序,正确的应为kwps.application
,毫无疑问,入参要求和程序ID完全匹配
。如果你报了同样的错误,不妨检查下注册表中的程序ID。
情况二
正常运行的程序,突然不行了
由于某种原因,程序的注册表信息有损坏导致COM
组件无法唤起客户端,比如wps
,但这种情况下有可能连手动也打不开wps
了,一般重装wps
能解决问题。
情况三
在IDE中可以运行,但在
cmd
窗口中就无法执行,在其他电脑上也正常
如图,这是我自己测试的
图一:在PowShell中运行出错
图二:在vscode中运行正常
其实,之前大概率碰到的就是这种情形,莫名其妙就崩了。我将这两张图发到群里时,估计有不少朋友都看出问题所在了:权限问题。
情景还原
截图中涉及到的是上面提到的下游机器之一,不过是在本地的开发环境中,是一套django
服务,runserver
时,命令行窗口使用了管理员身份
,图二是使用vscode控制台直接运行的,图一和图二最终运行的都是同一套win32com
服务。它们的唯一的差异,就是权限不同。所以,我有足够的理由推测:由权限引起的。为了验证我的推测,我做了下面的测试:
测试一
写个win32com
的最小实现:demo.py
from win32com.client import Dispatch
client = Dispatch('kwps.application')
client.Quit()
1、分别使用管理员身份
启动cmd
和PowerShell
,使用python demo.py
来运行这段脚本,结果都报错:无效的类字符串
;
2、使用当前用户身份来启动cmd
和PowerShell
,也就是正常打开命令行工具,使用python demo.py
来运行这段脚本,结果正常。
上面提到,我的win32com
运行在子进程中,为了保险,进一步测试在多进程中的表现如何,所以看测试二。
测试二
把demo.py变成多进程,如下:
python
import pythoncom
from multiprocessing import Process
from win32com.client import DispatchEx
def demo():
pythoncom.CoInitialize()
client = DispatchEx('kwps.application')
print('wps客户端实例:', client)
client.Quit()
pythoncom.CoUninitialize()
if __name__ == '__main__':
p = Process(target=demo)
p.start()
再次重复测试一的步骤,测试结果一致。不关乎进程,测试结果只和身份有关,管理员身份
和当前用户身份
最大的区别就是权限,意味着,即便是程序ID无误,也无法启动目标客户端。
更为详细的原因,我就不得而知了,超纲了。但已经完全可以确定,这种情况与权限有关,即以何种权限来启动程序,和当前的用户身份是否匹配。如果哪位大佬知晓更为本质的原因,欢迎点拨一二。
回到我的项目中,我一定是手贱了,在本地无意中以管理员身份
启动了命令行工具,在部署测试时,手贱在一台下游机器上执行了同样的操作。
由于知识有限,个人的分析并不一定正确,碰到的情况也并不一定和你的相同,请多多多交流。