Python内置next()在Gunicorn的工作机制及__iter__方法必要性探究

关于Python中next()函数与迭代器类的疑问 #

问题背景 #

以下是来自gunicorn.workers.sync.SyncWorker类self.handle方法的代码片段：

def handle(self, listener, client, addr):
        req = None
        try:
            if self.cfg.is_ssl:
                client = sock.ssl_wrap_socket(client, self.cfg)
            parser = http.RequestParser(self.cfg, client, addr)
            req = next(parser)
            self.handle_request(listener, req, client, addr)

其中parser是gunicorn.http.parser.RequestParser实例，它继承自gunicorn.http.parser.Parser类，该类定义如下：

class Parser(object):

    mesg_class = None

    def __init__(self, cfg, source, source_addr):
        self.cfg = cfg
        if hasattr(source, "recv"):
            self.unreader = SocketUnreader(source)
        else:
            self.unreader = IterUnreader(source)
        self.mesg = None
        self.source_addr = source_addr

        # request counter (for keepalive connetions)
        self.req_count = 0

    def __iter__(self):
        return self

    def __next__(self):
        # Stop if HTTP dictates a stop.
        if self.mesg and self.mesg.should_close():
            raise StopIteration()

        # Discard any unread body of the previous message
        if self.mesg:
            data = self.mesg.body.read(8192)
            while data:
                data = self.mesg.body.read(8192)

        # Parse the next request
        self.req_count += 1
        self.mesg = self.mesg_class(self.cfg, self.unreader, self.source_addr, self.req_count)
        if not self.mesg:
            raise StopIteration()
        return self.mesg

    next = __next__

调试发现，执行req = next(parser)时直接调用__next__方法，__iter__并未被触发；即使注释掉__iter__方法，代码依然能正常运行。

根据Python官方文档，next()函数的参数说明如下：

next(iterator)
next(iterator, default)
Retrieve the next item from the iterator by calling its next() method. If default is given, it is returned if the iterator is exhausted, otherwise StopIteration is raised.

疑问解答 #

1. 为什么next()可以接收RequestParser实例？

Python对迭代器的定义核心是实现__next__()方法（Python3）或next()方法（Python2），且该方法能返回下一个元素、在无元素时抛出StopIteration。官方文档里的“iterator”指的是符合这个协议的对象，而非必须同时实现__iter__()。

Parser类的__next__()完全满足迭代器的行为要求，所以可以直接被next()函数调用。

2. Parser类的__iter__方法是否必要？

分场景判断：

• 如果仅使用next()单独调用该对象，__iter__()确实没必要，就像你测试的那样，注释后不影响功能。
• 但如果要将该对象用于for循环迭代（比如for req in parser:），__iter__()是必须的——因为for循环的逻辑是先调用对象的__iter__()获取迭代器，再不断调用迭代器的__next__()直到抛出StopIteration。

另外，实现__iter__()并返回自身，是让对象同时成为“可迭代对象”和“迭代器”的常规设计方式，这样它既支持next()调用，也能直接在for循环中使用。Gunicorn保留这个方法，可能是为了兼容迭代场景的扩展，或者遵循Python迭代器的通用设计模式。

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