Windows环境下编译Python C扩展遭遇链接错误

从你的报错信息来看，问题主要集中在链接阶段的符号缺失，结合你的环境（Win Server 2019 x64、Python3.9、MSVC2017），我帮你拆解问题并给出具体修复步骤：

核心问题分析 #

你的错误分为三类：

1. JWT库的函数符号未找到：比如jwt_free、jwt_decode，大概率是库的位数不匹配或者链接路径/名称错误；
2. Windows系统库符号缺失：比如__imp_RegCloseKey、__imp_CryptGenRandom，这是因为mysqlclient依赖Windows系统的一些基础库，但你没在setup.py中声明；
3. include和library路径混淆：你把include_dirs直接赋值给了library_dirs，导致大量无关路径被加入链接搜索，反而干扰了正确库的查找。

分步修复方案 #

1. 先修正include和library路径的低级错误 #

你的Extension定义里犯了一个明显的错误：把头文件路径include_dirs赋值给了库路径library_dirs，这会导致链接器去头文件目录找库文件，完全不对。赶紧改过来：

FLD=Extension('Download',
              libraries=['mysqlclient', 'zlib', 'libjwt'],  # 这里可能要改jwt的库名，后面说
              library_dirs=library_dirs,  # 原来写的是include_dirs，必须改成library_dirs
              include_dirs=include_dirs,
              sources=['Download.c'],
              language='c')

2. 补充mysqlclient依赖的Windows系统库 #

mysqlclient在Windows上依赖几个系统库，你需要把它们加入libraries列表：

libraries=['mysqlclient', 'zlib', 'libjwt', 'advapi32', 'secur32', 'crypt32']

• advapi32：提供注册表操作相关函数（对应RegCloseKey等错误）；
• secur32：提供SID和账户信息相关函数（对应EqualSid等错误）；
• crypt32：提供加密随机数生成函数（对应CryptGenRandom等错误）。

3. 确保所有库都是64位版本 #

你的环境是64位Python+64位系统，绝对不能混用32位库：

• 把zlib的路径从zlib_x86-windows全部改成zlib_x64-windows，比如：

  include_dirs=[
      # 原来的zlib_x86-windows全部替换成zlib_x64-windows
      r"C:\src\vcpkg\packages\zlib_x64-windows\include",
      # ...其他路径...
  ]
  library_dirs=[
      # 同样替换zlib的库路径（如果需要的话）
      # ...其他路径...
  ]
  

• 检查手动编译的libjwt：打开VS工程时要选择x64平台编译，而不是默认的Win32。编译完成后，确认C:\libjwt\build\libjwt\Debug下的库文件是64位的（可以用VS的dumpbin工具验证：dumpbin /headers libjwt.lib，看machine类型是否是x64）。

4. 确认JWT库的名称是否正确 #

手动编译的libjwt，库文件名可能是libjwt.lib而不是jwt.lib，所以你需要把libraries里的jwt改成libjwt。如果不确定，直接去你编译的目录看文件名，比如如果是jwt.lib就保留jwt，如果是libjwt.lib就写libjwt。

5. 清理冗余路径 #

你的include_dirs和library_dirs里加了很多不必要的路径（比如把bin、lib目录加到include_dirs里），建议精简：

• include_dirs只保留头文件所在目录，比如zlib的include目录、picojson的include目录、libmysql的include/mysql目录、libjwt的include目录；
• library_dirs只保留库文件（.lib）所在目录，比如libmysql的debug/lib目录、libjwt的Debug目录、zlib的lib目录。

修改后的完整setup.py示例 #

from setuptools import setup, Extension
import os, platform

# 精简后的头文件路径，只保留真正需要的include目录
include_dirs=[
    r"C:\src\vcpkg\packages\zlib_x64-windows\include",
    r"C:\vcpkg\vcpkg\packages\picojson_x64-windows\include",
    r"C:\libjwt\include",
    r"C:\src\vcpkg\packages\libmysql_x64-windows\include\mysql",
]

# 精简后的库文件路径，只保留.lib所在目录
library_dirs=[
    r"C:\src\vcpkg\packages\libmysql_x64-windows\debug\lib",
    r"C:\libjwt\build\libjwt\Debug",
    r"C:\src\vcpkg\packages\zlib_x64-windows\lib",
]

FLD=Extension('Download',
              # 添加系统依赖库，修正jwt库名
              libraries=['mysqlclient', 'zlib', 'libjwt', 'advapi32', 'secur32', 'crypt32'],
              library_dirs=library_dirs,  # 修正为正确的library_dirs
              include_dirs=include_dirs,
              sources=['Download.c'],
              language='c')

setup(
    name='Download',
    version='1.0',
    ext_modules=[FLD]
)

最后编译注意事项 #

1. 打开VS2017的x64 Native Tools Command Prompt，再执行python setup.py install，确保编译环境是64位的；
2. 如果用Debug模式编译，确保所有库都是Debug版本（比如libmysql的debug库、libjwt的debug库），不要混合Release和Debug库，否则会出现链接错误；
3. 如果还是有JWT的符号错误，检查你的Download.c里是否正确包含了jwt的头文件，并且函数调用方式是否和库的导出一致（比如是否是C链接，有没有extern "C"包裹头文件，如果是C++编译的话，但你这里是C语言，所以应该没问题）。

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