`methodcaller` is not thread-safe (or re-entrant) · Issue #127065 · python/cpython · GitHub

Bug report

EDIT: edited to clarify that the issue is in the C implementation of operator.methodcaller.

Originally reported by @ngoldbaum in crate-py/rpds#101

Reproducer

from operator import methodcaller

from concurrent.futures import ThreadPoolExecutor

class HashTrieMap():
    def keys(self):
        return None
    def values(self):
        return None
    def items(self):
        return None

num_workers=1000

views = [methodcaller(p) for p in ["keys", "values", "items"]]

def work(view):
    m, d = HashTrieMap(), {}
    view(m)
    view(d)

iterations = 10

for _ in range(iterations):
    
    executor = ThreadPoolExecutor(max_workers=num_workers)

    for view in views:
        futures = [executor.submit(work, view) for _ in range(num_workers)]
        results = [future.result() for future in futures]

Once every 5-10 runs, the program prints:

TypeError: descriptor 'keys' for 'dict' objects doesn't apply to a 'HashTrieMap' object

The problem is that operator.methodcaller is not thread-safe because it modifies the vectorcall_args, which is shared across calls:

cpython/Modules/_operator.c

Lines 1646 to 1666 in 0af4ec3

    
           static PyObject * 
        
           methodcaller_vectorcall( 
        
                   methodcallerobject *mc, PyObject *const *args, size_t nargsf, PyObject* kwnames) 
        
           { 
        
               if (!_PyArg_CheckPositional("methodcaller", PyVectorcall_NARGS(nargsf), 1, 1) 
        
                   || !_PyArg_NoKwnames("methodcaller", kwnames)) { 
        
                   return NULL; 
        
               } 
        
               if (mc->vectorcall_args == NULL) { 
        
                   if (_methodcaller_initialize_vectorcall(mc) < 0) { 
        
                       return NULL; 
        
                   } 
        
               } 
        
               assert(mc->vectorcall_args != 0); 
        
               mc->vectorcall_args[0] = args[0]; 
        
               return PyObject_VectorcallMethod( 
        
                       mc->name, mc->vectorcall_args, 
        
                       (PyTuple_GET_SIZE(mc->xargs)) | PY_VECTORCALL_ARGUMENTS_OFFSET, 
        
                       mc->vectorcall_kwnames); 
        
           }

I think this is generally unsafe, not just for free threading. The vectorcall args array needs to be valid for the duration of the call, and it's possible for methodcaller to be called reentrantly or by another thread while the call is still ongoing.

Linked PRs

Hmm, actually it looks like a thread safety issue in methodcaller.

Yeah, I noticed early it wasn't triggering if I called the descriptors directly without going through methodcaller.

pythongh-127065: Make `methodcaller` thread-safe in free threading build

I think the optimized vectorcall implementation from #107201 is not reentrant or thread-safe (even with the GIL) because the shared vectorcall_args array is modified during each invocation:

cpython/Modules/_operator.c

Line 1661 in 3926842

mc->vectorcall_args[0] = args[0];

Most (or all) of our current vectorcall implementations extract out args[0] early, but that's not guaranteed and the vectorcall protocol is a public API.

For now, I'm planning to just disable the optimization in the free threading build (#127109), but I don't see an easy way of making it thread-safe, and I think we should consider reverting #107201 in 3.13 and main.

cc @eendebakpt @corona10 @vstinner

gh-127065: Make `methodcaller` thread-safe in free threading build (#…

pythongh-127065: Make `methodcaller` thread-safe in free threading bu…

[3.13] gh-127065: Make `methodcaller` thread-safe in free threading b…

I agree this looks like a bug also in the normal build. The issue is hard to trigger in the normal build though, as indeed most vectorcall implementations (including the PyObject_VectorcallMethod used by the methodcaller) get args[0] before doing any work).

One option to make the vectorcall implementation thread-safe (and re-entrant) would be to copy the entire mc->vectorcall_args to a temporary buffer before setting the first element to args[0]. An implementation of this idea is main...eendebakpt:methodcaller_ft.

A quick benchmark (using the script from #107201) shows there is still a significant performance increase:

Current main:

call: Mean +- std dev: 48.2 ns +- 4.1 ns
creation: Mean +- std dev: 58.3 ns +- 3.4 ns
creation+call: Mean +- std dev: 114 ns +- 5 ns
call kwarg: Mean +- std dev: 63.8 ns +- 3.7 ns
creation kwarg: Mean +- std dev: 92.7 ns +- 3.1 ns
creation+call kwarg: Mean +- std dev: 187 ns +- 7 ns

Disable the vectorcall (this is the solution Sam added to the FT build):

call: Mean +- std dev: 78.2 ns +- 3.2 ns
creation: Mean +- std dev: 56.6 ns +- 2.7 ns
creation+call: Mean +- std dev: 136 ns +- 6 ns
call kwarg: Mean +- std dev: 124 ns +- 6 ns
creation kwarg: Mean +- std dev: 92.3 ns +- 4.1 ns
creation+call kwarg: Mean +- std dev: 228 ns +- 10 ns

Copy mc->vectorcall_args to a temporary buffer:

call: Mean +- std dev: 50.9 ns +- 1.6 ns
creation: Mean +- std dev: 56.6 ns +- 4.8 ns
creation+call: Mean +- std dev: 118 ns +- 6 ns
call kwarg: Mean +- std dev: 64.8 ns +- 2.5 ns
creation kwarg: Mean +- std dev: 91.9 ns +- 4.9 ns
creation+call kwarg: Mean +- std dev: 194 ns +- 9 ns

(all benchmarks without PGO and with the normal Python build)

@colesbury Is this idea an option for the free-threading build?
@Yhg1s What would you like to do for the 3.13 branch?

An implementation of this idea is main...eendebakpt:methodcaller_ft.

Can you create a PR? I cannot open the link, it takes too long and GitHub displays an error.

I removed the draft status from the PR (thanks to @colesbury for some good suggestions). Both PR #127109 or reverting #107201 are good options I think (a classic trade-off between performance and added complexity, except that in this case the status quo is not good)

gh-127065: Make methodcaller thread-safe and re-entrant (GH-127746)

The issue has been addressed on main and on 3.13 the optimization has been removed for the free-threading build. I think we can close this issue, unless we would also like to address the issue for 3.13 with the normal build.

@Yhg1s Can you decide on 3.13?

pythongh-127065: Make methodcaller thread-safe and re-entrant (python…

pythongh-127065: Make `methodcaller` thread-safe in free threading bu…

Closed as it is fixed in main branch.

`methodcaller` is not thread-safe (or re-entrant) · Issue #127065 · python/cpython · GitHub

Repository navigation

methodcaller is not thread-safe (or re-entrant) #127065

Bug report

Linked PRs

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

	static PyObject *
	methodcaller_vectorcall(
	methodcallerobject mc, PyObject const args, size_t nargsf, PyObject kwnames)
	{
	if (!_PyArg_CheckPositional("methodcaller", PyVectorcall_NARGS(nargsf), 1, 1)
	\|\| !_PyArg_NoKwnames("methodcaller", kwnames)) {
	return NULL;
	}
	if (mc->vectorcall_args == NULL) {
	if (_methodcaller_initialize_vectorcall(mc) < 0) {
	return NULL;
	}
	}

	assert(mc->vectorcall_args != 0);
	mc->vectorcall_args[0] = args[0];
	return PyObject_VectorcallMethod(
	mc->name, mc->vectorcall_args,
	(PyTuple_GET_SIZE(mc->xargs)) \| PY_VECTORCALL_ARGUMENTS_OFFSET,
	mc->vectorcall_kwnames);
	}

`methodcaller` is not thread-safe (or re-entrant) · Issue #127065 · python/cpython · GitHub

Repository navigation

methodcaller is not thread-safe (or re-entrant) #127065

Description

Bug report

Linked PRs

Activity

colesbury commented on Nov 20, 2024

ngoldbaum commented on Nov 20, 2024

colesbury commented on Nov 21, 2024

eendebakpt commented on Nov 23, 2024

vstinner commented on Nov 25, 2024

eendebakpt commented on Dec 1, 2024

eendebakpt commented on Jan 1, 2025

kumaraditya303 commented on Apr 20, 2025

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions