Python与C++库字符串传递异常排查：段错误、std::bad_alloc等问题

你的问题核心在于ctypes无法直接处理C++的std::string类型，而且没有显式声明C++函数的参数和返回类型，导致ctypes默认的类型转换出错，进而引发段错误、std::bad_alloc这些内存问题。下面一步步帮你修正：

一、先明确：ctypes和C++类型的兼容性 #

ctypes是为C语言设计的，直接传递/返回C的std::string会出问题——Python不知道怎么处理C类的内存布局。我们需要用C语言兼容的类型（char*）做交互，或者在C++端封装适配函数。

二、修正「Python传递字符串到C++」的问题 #

1. 处理passInACharArray(char*)的段错误 #

你之前的问题出在两点：

• Python字符串是Unicode，需要先转成UTF-8编码的bytes对象（用b"xxx"或者.encode()）
• 必须给C++函数声明参数类型，不然ctypes会把Python对象直接当作指针传递，类型完全不匹配

修正后的Python代码片段：

from ctypes import *
import os
libPath = os.path.join(os.getcwd(), "mylib.so")
lib = cdll.LoadLibrary(libPath)

# 显式声明函数参数类型：接收一个char*
lib.passInACharArray.argtypes = [c_char_p]

string = "hello from python".encode("utf-8")  # 转成bytes格式
lib.passInACharArray(string)

2. 处理passInAString(std::string)的std::bad_alloc #

因为ctypes不认识std::string，直接传递会导致C端试图把Python对象的内存当作std::string解析，必然触发内存错误。解决方法是在C端封装一个接收char*的适配函数，再转成std::string：

修改C++代码，新增适配函数：

#define DLLEXPORT extern "C"
#include <cstdio>
#include <string>

// 原函数保留，新增适配函数
DLLEXPORT void passInAStringWrapper(char* incomingCStr) {
    std::string incomingString(incomingCStr);
    printf("Recieved message in passInAStringWrapper\n");
    printf("Recieved incoming message: %s\n", incomingString.c_str());
}

Python端同样声明参数类型，传递bytes：

lib.passInAStringWrapper.argtypes = [c_char_p]
lib.passInAStringWrapper(string)

三、修正「C++返回字符串到Python」的问题 #

1. 处理returnACharArray()的返回值 #

你之前得到的数字是未转换的指针，需要告诉ctypes这个函数返回的是char*，这样它会自动转成Python的bytes对象：

Python端声明返回类型：

# 声明函数返回类型为char*
lib.returnACharArray.restype = c_char_p

ret = lib.returnACharArray()
print("recieved char*: " + ret.decode("utf-8"))  # bytes转成字符串

注意：C++端返回的字符串必须是静态内存分配的（比如字符串字面量），如果是动态分配的（比如new char[]），需要额外提供释放内存的函数，避免内存泄漏。

2. 处理returnAString()的返回值 #

同样不能直接返回std::string，需要在C++端封装成返回char*的函数：

DLLEXPORT char* returnAStringWrapper() {
    std::string ret = "Returning string from lib";
    // 用strdup分配内存，后续需要释放
    return strdup(ret.c_str());
}

// 新增释放函数，避免内存泄漏
DLLEXPORT void freeCharPtr(char* ptr) {
    free(ptr);
}

Python端调用示例：

lib.returnAStringWrapper.restype = c_char_p
lib.freeCharPtr.argtypes = [c_char_p]

ret_bytes = lib.returnAStringWrapper()
ret_str = ret_bytes.decode("utf-8")
print("recieved string: " + ret_str)
lib.freeCharPtr(ret_bytes)  # 释放动态分配的内存

四、完整可运行代码示例 #

修正后的C++代码（mylib.cpp） #

#define DLLEXPORT extern "C"
#include <cstdio>
#include <string>
#include <cstring>

DLLEXPORT char* returnACharArray() {
    return "Returning char* from lib"; // 静态字符串，安全
}

DLLEXPORT char* returnAStringWrapper() {
    std::string ret = "Returning string from lib";
    return strdup(ret.c_str()); // 动态分配内存，需后续释放
}

DLLEXPORT void freeCharPtr(char* ptr) {
    free(ptr);
}

DLLEXPORT void passInACharArray(char* incomingString) {
    printf("Recieved message in passInACharArray\n");
    printf("Recieved incoming message: %s\n", incomingString);
}

DLLEXPORT void passInAStringWrapper(char* incomingCStr) {
    std::string incomingString(incomingCStr);
    printf("Recieved message in passInAStringWrapper\n");
    printf("Recieved incoming message: %s\n", incomingString.c_str());
}

Linux下编译命令：

g++ -shared -fPIC mylib.cpp -o mylib.so

修正后的Python代码 #

from ctypes import *
import os

libPath = os.path.join(os.getcwd(), "mylib.so")
lib = cdll.LoadLibrary(libPath)

# 配置传递字符串的函数
lib.passInACharArray.argtypes = [c_char_p]
lib.passInAStringWrapper.argtypes = [c_char_p]

# 配置返回字符串的函数
lib.returnACharArray.restype = c_char_p
lib.returnAStringWrapper.restype = c_char_p
lib.freeCharPtr.argtypes = [c_char_p]

# 测试传递字符串
python_str = "hello from python"
bytes_str = python_str.encode("utf-8")
lib.passInACharArray(bytes_str)
lib.passInAStringWrapper(bytes_str)

# 测试接收字符串
ret_char_arr = lib.returnACharArray()
print("recieved char*: " + ret_char_arr.decode("utf-8"))

ret_str_wrapper = lib.returnAStringWrapper()
print("recieved string: " + ret_str_wrapper.decode("utf-8"))
lib.freeCharPtr(ret_str_wrapper) # 释放动态分配的内存

关键要点总结 #

• 永远给ctypes调用的C/C++函数显式声明argtypes（参数类型）和restype（返回类型），默认类型转换几乎一定会出错
• 避免直接用std::string和ctypes交互，用C语言的char*作为中间层
• 动态分配的内存一定要记得释放，避免内存泄漏

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