Windows下构建Kotlin Native libcurl应用遇链接错误求助

算力阿峰

2026-8-3

Kotlin Native + libcurl Windows链接错误：未定义符号解决方法

你的链接错误核心原因是架构不匹配，加上C Interop定义文件和链接配置的小问题，以下是具体解决步骤：

1. 修复架构不匹配问题

你当前配置的Kotlin Native目标是mingwX64（64位），但链接的是32位版本的libcurl库（路径中的libcurl-vc-x86-release-dll明确标识了x86架构）。64位编译器无法识别32位库中的符号，导致未定义错误。

解决：

下载或编译64位版本的libcurl（比如选择libcurl-vc-x64-release-dll-ipv6-sspi-schannel版本）
更新build.gradle.kts中链接路径为64位库的libcurl.lib位置

2. 完善libcurl.def文件

默认的def文件仅指定了头文件，但Windows下libcurl的DLL导出符号需要显式声明，否则Kotlin Native无法生成正确的导入包装器。

修改libcurl.def，二选一即可：

方案A：添加链接参数到def文件

headers = curl/curl.h
headerFilter = curl/*
linkerOpts = -LC:/Users/Nicola/Documents/curl-7.87.0/curl-7.87.0/builds/libcurl-vc-x64-release-dll-ipv6-sspi-schannel/lib -lcurl

方案B：显式列出用到的函数符号

headers = curl/curl.h
headerFilter = curl/*
functions = curl_easy_init curl_easy_cleanup curl_easy_perform curl_easy_setopt curl_easy_strerror

3. 修正build.gradle.kts的链接配置

确保链接参数格式正确，Windows下clang++/lld-link推荐使用-L指定库目录、-l指定库名的方式：

binaries {
    executable {
        entryPoint = "main"
        // 替换为64位库的目录和库名
        linkerOpts("-LC:\\Users\\Nicola\\Documents\\curl-7.87.0\\curl-7.87.0\\builds\\libcurl-vc-x64-release-dll-ipv6-sspi-schannel\\lib", "-lcurl")
    }
}