C++中同名静态与普通模板成员函数重载的调用问题

先还原你的代码场景：

#include <array>

class MyClass {
public:
    template <size_t K>
    static void test(std::array<int, K> arr) {}

    template <size_t K>
    void test(int val) {}
};

int main() {
    MyClass::test<1>({1}); // 编译报错：call to non-static member function without an object argument
    return 0;
}

问题根源 #

你误以为通过类名调用时，非静态成员函数会被排除在重载候选之外，但C++的重载解析规则并不是这样的：

1. 候选函数的收集：编译器会先收集所有在类作用域内名为test的成员函数，不管是静态还是非静态，都会纳入候选集。
2. 模板实参替换：你显式指定了模板参数<1>，两个模板都会被实例化：
   • 静态版本：static void MyClass::test(std::array<int,1>)
   • 非静态版本：void MyClass::test(int)
3. 参数匹配优先级：对于实参{1}，两个函数都能匹配：
   • 非静态版本的int参数可以直接通过单元素列表初始化，属于精确匹配；
   • 静态版本的std::array<int,1>参数需要聚合初始化，匹配优先级不如前者。
     编译器会优先选择匹配度更高的非静态版本，但随后发现调用非静态成员函数没有提供对象实例，因此抛出错误。

解决方法 #

有几种方式可以让编译器正确选择静态版本：

• 显式构造std::array：让实参类型完全匹配静态函数的参数，这样非静态版本会因为类型不匹配被排除：

  MyClass::test<1>(std::array<int,1>{1});
  

• 强制转换函数指针：明确指定要调用的静态函数类型：

  using StaticTestFunc = void(*)(std::array<int,1>);
  (static_cast<StaticTestFunc>(&MyClass::test<1>))({1});
  

• 重命名静态函数：如果允许，直接给静态函数换个名字，从根源避免重载冲突。

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