[BUG]: Simply creating subinterpreter leaks memory

[justend29]

Required prerequisites

• Make sure you've read the documentation. Your issue may be addressed there.
• Search the issue tracker and Discussions to verify that this hasn't already been reported. +1 or comment there if it has.
• Consider asking first in the Gitter chat room or in a Discussion.

What version (or hash if on master) of pybind11 are you using?

90bc05c

Problem description

The mere use of a subinterpreter leaks memory. Memory leaks were found with python 3.12 and 3.13 For example:

#include <pybind11/embed.h>
#include <pybind11/subinterpreter.h>

int main() {
  pybind11::initialize_interpreter();
  const auto sub_python = pybind11::subinterpreter::create();
}

From the pybind11 project source, I am building this minimal example with the following command

g++ test.cpp -fsanitize=address  -I /usr/include/python3.13 -I ./include -l python3.13

Reference of g++ version:

g++ --version
g++ (GCC) 15.1.1 20250729
Copyright (C) 2025 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

The sanitizer's output is included as an attachment: sanitizer.txt

Reproducible example code

#include <pybind11/embed.h>
#include <pybind11/subinterpreter.h>

int main() {
  pybind11::initialize_interpreter();
  const auto sub_python = pybind11::subinterpreter::create();
}

Is this a regression? Put the last known working version here if it is.

Not a regression

[henryiii]

CC @b-pass, though I think I remember this might be intentional, since there are rules about keeping it alive?

[b-pass]

There are a lot of leaks from internal python modules, there's not really anything that we can do about those. There are a few things that are leaking from pybind11 internals. We do clean up the internals itself, but we don't clean up the ~3 types that internals creates (static property, meta class, and function record).

This was always leaking, but it was less of an issue when there was only one interpreter because creating and destroying it multiple times in one program was more rare. With sub-interpreters, it can happen a lot more.

Fixing it will probably be tricky because we don't have a lot of control over the destruction order of things in python which might make calls back into pybind11 during sub-interpreter destruction. So, if we DECREF these things during shutdown then python might subsequently delete them.... for example, the base HeapType for all pybind11 objects.