适配Python3.9 64位的LibHaru Python绑定调试求助

核心问题根源 #

你遇到的OverflowError本质是64位环境下指针类型不匹配：原libharu的ctypes绑定是为32位设计的，把HPDF_Doc（本质是64位指针，8字节）错误定义为32位整数类型（如c_int，4字节），导致64位指针值超出32位整数范围，触发溢出。

调试与修复步骤 #

1. 修正核心类型定义 #

打开hpdf.py，找到HPDF_Doc、HPDF_Page等句柄类型的定义，全部替换为64位兼容的指针类型：

from ctypes import c_void_p, POINTER, Structure, CFUNCTYPE, c_int

# 定义空结构作为句柄容器（不需要内部字段，仅用于类型标识）
class HPDF_Doc(Structure):
    _fields_ = []
HPDF_DocPtr = POINTER(HPDF_Doc)

class HPDF_Page(Structure):
    _fields_ = []
HPDF_PagePtr = POINTER(HPDF_Page)

# 修正错误回调函数的类型（确保参数中的指针用c_void_p）
HPDF_ErrorHandler = CFUNCTYPE(c_int, HPDF_DocPtr, c_int, c_int, c_void_p)

2. 修正API函数的参数和返回值 #

针对每个调用的API，显式指定argtypes和restype，避免ctypes自动推断错误：

# 以HPDF_New和HPDF_AddPage为例
import ctypes
lib = ctypes.CDLL("libhpdf.dll")

# 修正HPDF_New
HPDF_New = lib.HPDF_New
HPDF_New.argtypes = [HPDF_ErrorHandler, c_void_p]
HPDF_New.restype = HPDF_DocPtr

# 修正HPDF_AddPage
HPDF_AddPage = lib.HPDF_AddPage
HPDF_AddPage.argtypes = [HPDF_DocPtr]
HPDF_AddPage.restype = HPDF_PagePtr

3. 调试指针传递问题 #

• 打印HPDF_New返回的指针值，验证是否为64位地址：

  pdf = HPDF_New(error_handler, None)
  print(f"HPDF_Doc pointer: {pdf}")
  # 64位环境下应该输出类似 <__main__.LP_HPDF_Doc object at 0x0000021F...> 或长整数地址
  

• 如果之前已经用错误类型接收了指针，用ctypes.cast转换后再传递：

  from ctypes import cast
  # 假设pdf是错误的整数类型
  pdf_ptr = cast(c_void_p(pdf), HPDF_DocPtr)
  page = HPDF_AddPage(pdf_ptr)
  

4. 验证位数一致性 #

• 确认编译的DLL是64位：在VS命令行执行dumpbin /headers libhpdf.dll，查看File Header下的Machine字段是否为x64。
• 确认Python是64位：执行python -c "import sys; print(sys.maxsize > 2**32)"，返回True则为64位。

5. 检查回调函数的调用约定 #

如果错误处理函数仍有问题，确保回调函数使用正确的调用约定（VS编译的DLL默认是stdcall，但libharu通常用cdecl），可以在CFUNCTYPE中指定：

HPDF_ErrorHandler = CFUNCTYPE(c_int, HPDF_DocPtr, c_int, c_int, c_void_p, use_errno=False, use_last_error=False)
# 如果是stdcall调用约定，用WINFUNCTYPE替代CFUNCTYPE

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