Python提取PDF文本时Popen对象不可解包TypeError报错求助

报错TypeError: cannot unpack non-iterable Popen object的触发逻辑非常明确：
subprocess.Popen（代码中简写为sp.Popen）调用后返回的是单个Popen进程对象，不是(标准输出, 标准错误)的二元元组，直接写out, err = sp.Popen(...)试图把单个对象拆包赋值给两个变量，就会触发这个类型错误。

除了这个直接触发报错的问题，代码还有几个隐藏bug，运行时也会出问题：

• 错误把Popen对象当成了标准输出内容，后续调用out.decode("utf-8")时会因为Popen对象没有decode方法抛出属性错误
• 创建Popen时传入了stdin=sp.PIPE参数，但从未向子进程标准输入写入内容，容易触发子进程管道死锁
• 直接用字符串加法拼接文件路径，跨系统运行时容易因为路径分隔符不匹配找不到文件
• 文件写入用了手动open/close，中途如果抛出异常会导致文件句柄泄漏
• 函数外部重复写了一行Popen调用，脱离函数作用域后相关变量未定义会触发名称错误
• 检查的是系统路径下的pdftotext是否存在，但实际运行时调用的是自己拼接的POPPLER_PATH路径下的pdftotext.exe，检查逻辑和实际执行逻辑不匹配

import os
import subprocess as sp
from shutil import which
from flask import current_app

def extract_clean_text_lisible(path_input, path_output):
    # 检查pdftotext是否可用
    if not which("pdftotext"):
        raise EnvironmentError("pdftotext not installed, please install poppler first")
    
    # 统一用os.path.join拼接路径，避免分隔符问题
    full_input_path = os.path.join(current_app.config['PROJECT_PATH'], path_input)
    full_output_path = os.path.join(current_app.config['PROJECT_PATH'], path_output)
    pdftotext_bin = os.path.join(current_app.config['POPPLER_PATH'], "pdftotext.exe")

    # 初始化子进程，不需要传stdin就不要加PIPE参数
    proc = sp.Popen(
        [pdftotext_bin, "-layout", "-enc", "UTF-8", full_input_path, "-"],
        stdout=sp.PIPE,
        stderr=sp.PIPE
    )
    # 用communicate读取子进程输出，等待进程执行结束
    out_bytes, err_bytes = proc.communicate()
    # 检查子进程执行是否报错
    if proc.returncode != 0:
        raise RuntimeError(f"pdftotext execute failed: {err_bytes.decode('utf-8', errors='ignore')}")
    # 解码文本内容
    text_content = out_bytes.decode("utf-8", errors="ignore")

    # 用上下文管理器写文件，自动关闭句柄
    with open(full_output_path, "w", encoding="utf-8") as f:
        f.write(text_content)

    return text_content

• 去掉了错误的Popen对象拆包写法，先实例化Popen对象，再调用communicate()方法获取标准输出、标准错误的字节内容
• 移除了不必要的stdin=sp.PIPE参数，避免管道死锁
• 所有路径拼接替换为os.path.join()，兼容不同操作系统的路径规则
• 文件写入替换为with上下文管理器写法，自动处理文件关闭逻辑
• 增加了子进程返回码检查，pdftotext执行出错时可以直接拿到错误信息
• 调整了pdftotext存在性检查的顺序，先检查再执行后续逻辑
• 删除了函数外部多余的重复Popen调用代码，避免作用域错误
• 解码时增加了errors="ignore"参数，遇到非法编码字符时不会直接中断程序

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