在Python开发中，当我们使用类名后加括号的方式创建对象时，解释器会先调用类的__new__方法分配内存，再调用__init__完成初始化。如果__init__或__new__定义了没有默认值的参数，而调用时没有提供足够的位置实参，就会抛出“TypeError: __init__() missing 1 required positional argument”之类的错误。这个机制本质上源于Python函数调用的参数绑定规则，而非类系统特有的黑盒逻辑。
要理解这个错误，首先需要明确位置参数和关键字参数的区别。位置参数要求调用时按照定义顺序传入，而关键字参数通过“名称=值”的形式可以打乱顺序。当一个类这样定义时：
class User:
def __init__(self, name, age):
self.name = name
self.age = age
# 错误示例：只传了一个参数
u = User("Alice") # TypeError: __init__() missing 1 required positional argument: 'age'
上面代码中，age是没有默认值的必填位置参数。调用User("Alice")时，解释器把"Alice"绑定给name，发现age没有拿到值，于是直接报错。这种错误在重构类时非常常见，比如给原有类增加了新的必填字段却忘了更新所有调用点。
另一种容易踩坑的情况是参数顺序写反。Python不允许把无默认值的参数放在有默认值的参数之后以外，还经常出现开发者误以为某些参数是可选的。例如：
class Config:
def __init__(self, path, debug=False, timeout=30):
self.path = path
self.debug = debug
self.timeout = timeout
# 如果写成这样，虽然不报缺少参数，但语义错误
c = Config("/etc/app", True) # debug=True, timeout使用默认
这里虽然没有触发“缺少位置参数”错误，但如果在path前插入一个必填参数，旧调用就会立刻失败。因此保持必填参数在前、可选参数在后是良好的设计习惯。
继承场景下的参数透传问题
在子类化时，如果子类重写了__init__却没调用父类初始化，或者父类增加了必填参数而子类没透传，也会引发该错误。看下面这段有问题的代码：
class Base:
def __init__(self, token):
self.token = token
class Sub(Base):
def __init__(self, name):
# 忘记调用 super().__init__
self.name = name
s = Sub("test") # 本身不报缺参数，但若Base逻辑被间接调用就会出错
更隐蔽的问题是当使用super()但参数不匹配：
class Base:
def __init__(self, token, version):
self.token = token
self.version = version
class Sub(Base):
def __init__(self, name, token):
super().__init__(token) # 缺少 version 参数
self.name = name
s = Sub("svc", "abc") # TypeError: __init__() missing 1 required positional argument: 'version'
解决方法是使用关键字参数显式透传，或者统一通过*args, **kwargs转发。不过**kwargs会掩盖接口变更，大型项目推荐明确写出参数名。
如何利用inspect快速定位缺失项
当类来自第三方库或代码层级很深时，可以用标准库inspect打印签名，确认究竟缺了哪个参数：
import inspect
class Service:
def __init__(self, host, port, ssl=False):
self.host = host
self.port = port
self.ssl = ssl
sig = inspect.signature(Service.__init__)
print(sig) # (self, host, port, ssl=False)
for name, param in sig.parameters.items():
if param.default is inspect.Parameter.empty and name != "self":
print("必填参数:", name)
这段脚本会列出所有没有默认值的参数，帮助我们在集成测试阶段就发现调用不匹配。配合IDE的类型提示，能大幅减少运行时才暴露的实例化错误。
从架构角度看，把配置对象与运行时依赖分离，使用工厂函数而非直接实例化重参数类，也能降低“缺少位置参数”的出现频率。例如用字典构建配置，再在工厂内做校验和填充，比散落各处的Class(a, b, c)调用更易于维护。
使用关键字参数规避陷阱
最实用的规避方案是尽量使用关键字参数调用类构造器，这样即使参数顺序调整也不会错：
class Database:
def __init__(self, url, pool_size, timeout=10):
self.url = url
self.pool_size = pool_size
self.timeout = timeout
# 推荐写法
db = Database(url="ipipp.com/db", pool_size=5)
关键字参数让代码自解释，也避免了对函数签名的顺序依赖。如果团队约定所有超过两个参数的类都必须用关键字调用，那么“缺少必需的位置参数”基本可以从项目中消失。同时，在__init__里对关键参数做断言或类型检查，能把错误暴露在更接近根源的位置。