Python unittest加载器调用__init__()时抛出TypeError求助

我之前调试测试套件时也碰到过一模一样的问题！这种TypeError在unittest.TestLoader初始化测试类时抛出，几乎都是因为测试代码不符合框架规范导致的，下面给你拆解最常见的原因和解决办法：

1. 测试类没有正确继承unittest.TestCase #

这是最容易踩的坑——如果你的测试类没有继承unittest.TestCase，加载器尝试将它作为测试类实例化时，就会因为缺少必要的初始化参数而报错。

错误示例：

# 没有继承TestCase，会导致加载器初始化失败
class UserTest:
    def test_user_creation(self):
        # ...测试逻辑

修正方式：
确保所有测试类都继承unittest.TestCase：

import unittest

class UserTest(unittest.TestCase):
    def test_user_creation(self):
        # ...测试逻辑

2. 重写测试类的__init__方法时未调用父类构造函数 #

如果你为了自定义逻辑重写了测试类的__init__，但没有正确传递参数给父类的构造函数，也会触发TypeError。

错误示例：

class UserTest(unittest.TestCase):
    def __init__(self):
        # 没有调用super().__init__，缺少必要的参数
        self.user = User()

修正方式：
要么完整传递参数给父类构造函数，要么改用unittest推荐的setUp()方法做初始化：

# 方式1：正确重写__init__
class UserTest(unittest.TestCase):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self.user = User()

# 方式2：推荐用setUp（更符合unittest规范）
class UserTest(unittest.TestCase):
    def setUp(self):
        self.user = User()

3. 测试文件中存在模块级别的测试类实例化 #

如果某个*_test.py文件在模块顶部直接实例化了测试类（比如UserTest()），加载器扫描文件时会提前执行这段代码，而手动实例化测试类需要传递测试方法名等参数，直接调用会触发TypeError。

排查方式：
检查所有*_test.py文件，确保没有在模块级别直接实例化测试类的代码。

4. 缩小范围定位问题 #

如果以上都排查不出问题，可以用“二分法”快速定位出错的文件：

1. 暂时移除所有*_test.py文件，只保留一个最简单的测试文件（如下）：

# sample_test.py
import unittest

class SampleTest(unittest.TestCase):
    def test_basic(self):
        self.assertEqual(1, 1)

2. 运行你的__main__.py，如果此时正常执行，说明问题出在被移除的某个测试文件中，逐个加回来排查即可。
3. 另外，你当前的start_dir="."可能会加载到项目根目录下其他非测试目录的*_test.py文件，建议把start_dir改成"tests"（如果你的测试都放在tests模块下），避免不必要的扫描。

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