使用cibuildwheel在Windows构建lupa的Python C扩展遇链接错误求助

问题背景 #

• 已在GitHub Actions手动完成Python 3.6版本Lupa wheel构建，可正常生成luajit21/luajit20/lua54~lua51全模块，安装后能正常导入使用
• 修改了setup.py第370行的平台判断逻辑：

  # 原代码
  -or (platform.startswith('win') and 'luajit' in os.path.basename(lua_bundle_path.rstrip(os.sep)))
  # 修改后代码
  +or (get_machine() != "AMD64" and  get_machine() != "x86_64" and 'luajit' in os.path.basename(lua_bundle_path.rstrip(os.sep)))
  

• 用cibuildwheel批量构建Python 3.6-3.12版本时，触发MSVC链接器错误：

  error: command 'C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.41.34120\bin\HostX86\x86\link.exe' failed with exit status 1120
  

• 手动构建成功的核心命令：python setup.py build_ext -i bdist_wheel --use-bundle --with-cython

排查与解决方案 #

链接错误1120是MSVC的符号重定义错误，核心原因是同一符号在多个编译单元/库中重复出现。结合手动构建成功、cibuildwheel失败的差异，从以下方向修复：

1. 修正setup.py的架构判断逻辑 #

你的修改排除了AMD64/x86_64架构的luajit bundle加载，导致64位环境下无法正确调用预编译的luajit库，转而编译重复符号。调整逻辑，让64位Windows仍保留原平台判断：

or ( (platform.startswith('win') and get_machine() in ("AMD64", "x86_64") and 'luajit' in os.path.basename(lua_bundle_path.rstrip(os.sep))) 
     or (get_machine() != "AMD64" and get_machine() != "x86_64" and 'luajit' in os.path.basename(lua_bundle_path.rstrip(os.sep))) )

2. 对齐cibuildwheel与手动构建的参数 #

确保cibuildwheel使用和手动一致的构建参数，在pyproject.toml或cibuildwheel配置文件中指定：

[tool.cibuildwheel]
build-command = "python setup.py build_ext -i bdist_wheel --use-bundle --with-cython"

如果只需要luajit21（性能最优），可以直接指定版本避免多版本编译冲突：

[tool.cibuildwheel]
build-command = "python setup.py build_ext -i bdist_wheel --use-bundle --with-cython --lua-version=luajit21"

3. 清理构建缓存 #

cibuildwheel会缓存中间编译产物，残留的旧文件可能导致符号冲突，添加预构建清理步骤：

python setup.py clean --all

4. 定位具体重复符号（可选） #

如果以上步骤无效，给MSVC链接器添加详细输出参数，在setup.py中修改扩展编译的链接参数：

import platform
from setuptools import Extension

# 找到扩展定义的位置，添加链接参数
if platform.system() == 'Windows':
    for ext in ext_modules:
        ext.extra_link_args.append('/VERBOSE')

重新构建后，查看链接器输出的重复符号，针对性排除冲突的库或编译单元。

验证步骤 #

1. 调整setup.py的架构判断逻辑
2. 配置cibuildwheel使用一致的构建命令
3. 清理缓存后重新触发构建
4. 安装生成的wheel，验证import lupa.luajit21是否正常运行

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