在C程序中使用Python.h执行Python脚本时出现Segmentation fault问题求助

嘿，我看了你遇到的段错误问题，用Python.h调用Python脚本时碰 segmentation fault 确实挺头疼的。我帮你分析下代码里可能出问题的地方，还有对应的解决办法：

1. 最可能的元凶：没检查文件是否打开成功 #

你代码里用fopen打开Python脚本后，完全没判断fd是不是NULL。如果因为路径拼接错误（比如当前目录路径不对、src/query.py不存在），fopen就会返回空指针，这时候把NULL传给PyRun_AnyFile直接就会触发段错误。

解决办法：在调用PyRun_AnyFile之前必须加检查：

if (fd == NULL) {
    fprintf(stderr, "Failed to open Python script: %s\n", python_file_path);
    free(python_file_path); // 别忘了提前释放内存
    return -1;
}

2. 路径缓冲区太小，导致getcwd失败 #

你用了64字节的cwd_buffer，如果你的当前工作目录路径长度超过64字节，getcwd会直接失败，这时候cwd_buffer里是一堆不确定的垃圾值，后续用strcpy/strcat拼接路径时，要么拼出无效路径，要么直接触发内存越界，这也是段错误的常见原因。

解决办法：用getcwd的动态分配模式，它会自动申请足够的内存：

char* cwd_buffer = getcwd(NULL, 0);
if (cwd_buffer == NULL) {
    perror("Failed to get current directory");
    return 1;
}
// 用完之后记得free(cwd_buffer);

3. 几个容易忽略的小问题 #

• 没关闭文件指针：你打开了fd但没调用fclose(fd)，虽然不是段错误的直接原因，但会导致资源泄漏，养成好习惯加上。
• 路径拼接用snprintf更安全：strcpy+strcat的组合如果处理不当容易内存越界，换成snprintf能避免这个问题：

  size_t path_len = strlen(cwd) + strlen("/src/query.py") + 1;
  python_file_path = malloc(path_len);
  snprintf(python_file_path, path_len, "%s/src/query.py", cwd);
  

• Python路径初始化：有时候脚本执行失败是因为Python找不到依赖，你可以在Py_Initialize()之后把脚本所在目录加到sys.path里：

  Py_Initialize();
  PyRun_SimpleString("import sys");
  PyRun_SimpleString("sys.path.insert(0, '.')"); // 或者脚本的实际目录
  

调试小技巧：用gdb定位精准错误 #

如果还是不确定哪一步出问题，用gdb跑一遍程序，能直接看到崩溃的调用栈：

gdb ./spotify-viewer-cli
run
# 崩溃后输入bt看调用栈
bt

这样能明确看到是PyRun_AnyFile因为空指针崩溃，还是其他内存问题。

修改后的完整参考代码 #

我把上面的修复点都整合到代码里了，你可以参考：

#include <Python.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>

int python_program(char* cwd)
{  
  char* python_file_path;
  FILE* fd;
  int run;

  // 用snprintf安全拼接路径
  size_t path_len = strlen(cwd) + strlen("/src/query.py") + 1;
  python_file_path = malloc(path_len);
  if (python_file_path == NULL) {
      fprintf(stderr, "Failed to allocate memory for path\n");
      return -1;
  }
  snprintf(python_file_path, path_len, "%s/src/query.py", cwd);

  // 打开文件并检查是否成功
  fd = fopen(python_file_path, "r");
  if (fd == NULL) {
      fprintf(stderr, "Could not open script: %s\n", python_file_path);
      free(python_file_path);
      return -1;
  }

  Py_Initialize(); 

  // 可选：添加当前目录到Python路径，避免依赖找不到
  PyRun_SimpleString("import sys");
  PyRun_SimpleString("sys.path.insert(0, '.')");

  run = PyRun_AnyFile(fd, python_file_path);

  Py_Finalize();

  // 关闭文件+释放内存
  fclose(fd);
  free(python_file_path);
  return run;
}

int main(int argc, char *argv[])
{
  // 动态获取当前目录
  char* cwd_buffer = getcwd(NULL, 0);
  if (cwd_buffer == NULL) {
      perror("Failed to get current working directory");
      return 1;
  }

  int result = python_program(cwd_buffer);
  free(cwd_buffer);
  
  return result;
}

最后提醒下，编译的时候要记得链接Python库，比如用gcc的话：

gcc your_code.c -o spotify-viewer-cli -lpython3.x -I/usr/include/python3.x

把x换成你实际的Python版本号就行。

备注：内容来源于stack exchange，提问作者Yuki