使用SWIG封装带默认参数的C++函数时Python调用报错如何解决？

问题原因 #

• 头文件依赖缺失：say.hpp中使用了uint32_t、int32_t等C++标准定长整数类型，但没有引入对应的标准头文件<cstdint>，SWIG解析头文件时无法识别这两类类型，将其判定为未知自定义类型，导致生成的Wrapper层参数类型检查逻辑异常，即便传入符合预期的参数，也无法匹配到对应的重载版本。
• 无符号整数类型适配问题：即使补全头文件，部分旧版本SWIG对标准定长无符号整数的默认转换规则较为严格，Python内置int默认是有符号类型，传参时如果没有显式配置类型映射，很容易触发类型不匹配报错；而默认参数会让SWIG自动生成多组重载函数，进一步提高了类型检查的严格度。

你移除默认参数后相当于函数仅保留const char*一个入参，不会触发整数类型的检查逻辑，因此可以正常运行。

解决方案 #

方案1：补全依赖+配置类型映射（最推荐） #

1. 首先修改say.hpp，补全标准头文件引用：

#include <iostream>
#include <cstdint> // 新增这行

void say(const char* text, const uint32_t x = 16, const uint32_t y = 24, const int32_t z = -1) {
    std::cout << text << std::endl;
}

2. 修改SWIG接口文件say.i，添加定长整数类型的映射声明，告诉SWIG这些类型对应的原生类型：

%module say
%{
#include "say.hpp"
#include <cstdint>
%}

// 新增类型声明
typedef unsigned int uint32_t;
typedef int int32_t;

%include "say.hpp"

重新执行编译命令即可正常调用。

方案2：替换为原生C++整数类型 #

如果对参数长度没有强要求，可以直接把函数参数中的uint32_t替换为unsigned int，int32_t替换为int，SWIG对C++原生整数类型的适配更完善，不会出现识别异常。

方案3：强制开启默认参数支持（仅适用于SWIG 3.0以下旧版本） #

旧版本SWIG默认可能没有开启默认参数的完整支持，可以在接口文件顶部添加%feature("defaultarguments")指令强制开启：

%module say
%feature("defaultarguments");
%{
#include "say.hpp"
%}

%include "say.hpp"

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