Python实现docx转PDF时，doc.Close()为何阻塞或终止后续代码？

问题核心原因 #

1. Word COM对象的线程模型限制：跨线程操作COM对象易导致阻塞或进程异常
2. 未正确释放COM资源：doc/Word对象未被显式释放，导致Word进程残留并阻塞操作
3. 代码结构错误：脚本级finally块中使用return语法非法，且会跳过正常流程

修复后的代码 #

import comtypes.client
import os
import pythoncom

# 用原始字符串避免路径转义问题
doc_path = r"absPath\to\document.docx"
pdf_path = r"absPath\to\save\location.pdf"

def docx_to_pdf():
    word = None
    doc = None
    try:
        # 初始化COM线程环境，确保单线程操作Word对象
        pythoncom.CoInitialize()
        
        word = comtypes.client.CreateObject("Word.Application")
        word.Visible = False
        word.DisplayAlerts = 0  # 屏蔽所有弹窗
        
        doc = word.Documents.Open(doc_path)
        doc.SaveAs(pdf_path, FileFormat=17)  # 17对应PDF格式
        
        # 先显式释放doc对象，再尝试关闭，避免进程持有资源阻塞
        comtypes.client.Release(doc)
        doc = None
        
        print(f"Document saved as PDF: {pdf_path}")
        return pdf_path

    except Exception as e:
        print(f"转换出错: {e}")
        return None

    finally:
        # 确保清理所有Word资源
        if word is not None:
            # 遍历关闭所有残留文档
            for open_doc in word.Documents:
                try:
                    comtypes.client.Release(open_doc)
                except:
                    pass
            # 退出Word并释放对象
            word.Quit()
            comtypes.client.Release(word)
        # 反初始化COM环境
        pythoncom.CoUninitialize()

# 执行转换
conversion_result = docx_to_pdf()
print(f"转换结果: {conversion_result}")

关键修改说明 #

• COM线程初始化：通过pythoncom.CoInitialize()/CoUninitialize()确保Word对象在单线程单元中运行，解决跨线程操作导致的阻塞
• 显式释放COM对象：在关闭文档前调用comtypes.client.Release()，强制释放资源，避免Word进程持有对象不释放
• 代码封装为函数：解决脚本级finally块使用return的语法错误，同时让资源管理更清晰
• 遍历清理文档：防止存在未被正确引用的残留文档，导致Word无法正常退出
• 原始字符串路径：避免路径中的转义字符（如\t）被解析为特殊字符，导致文件找不到

额外注意事项 #

• 确保本地安装了完整版Microsoft Word，且COM组件可正常调用
• 不要在多线程/异步环境中使用该代码，Word COM对象不支持跨线程调用
• 转换前检查目标路径是否有写入权限，源文档是否被其他程序锁定
• 如果仍出现Word进程残留，可手动在任务管理器中结束WINWORD.EXE进程后重试

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