如何用Python停止prometheus_client.http_server解决端口占用问题？

由于prometheus_client官方未提供直接的shutdown方法，可通过以下几种方式实现HTTP服务器的停止，解决多轮测试中的端口占用问题：

方案1：利用内部线程与服务器实例停止 #

start_http_server底层会启动一个线程运行_ThreadingSimpleServer实例，可通过线程对象获取服务器实例并调用shutdown方法：

from prometheus_client import start_http_server

# 启动服务器，保存返回的线程对象
server_thread = start_http_server(8000)

# 停止服务器的函数
def stop_prometheus_server():
    # 获取线程关联的服务器实例
    server = server_thread.server
    # 关闭服务器
    server.shutdown()
    # 等待线程结束
    server_thread.join()

注意：该方案依赖prometheus_client的内部实现，若库版本更新导致内部逻辑变化，可能需要调整代码。

方案2：自定义HTTP服务器实现启停控制 #

不依赖官方的start_http_server，手动创建HTTP服务器并管理生命周期，更稳定可控：

from prometheus_client import generate_latest, REGISTRY
from http.server import HTTPServer, BaseHTTPRequestHandler
import threading

class PrometheusRequestHandler(BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header('Content-Type', 'text/plain; version=0.0.4; charset=utf-8')
        self.end_headers()
        self.wfile.write(generate_latest(REGISTRY))

# 自定义启动函数，返回服务器实例和线程对象
def start_prometheus_server(port):
    server = HTTPServer(('0.0.0.0', port), PrometheusRequestHandler)
    server_thread = threading.Thread(target=server.serve_forever)
    server_thread.daemon = True
    server_thread.start()
    return server, server_thread

# 使用示例
server, server_thread = start_prometheus_server(8000)

# 停止服务器
def stop_prometheus_server(server, server_thread):
    server.shutdown()
    server_thread.join()
    server.server_close()

方案3：测试时使用随机端口规避冲突 #

若测试无需固定端口，可启动时指定端口为0，让系统自动分配空闲端口，从根源避免占用问题：

from prometheus_client import start_http_server

# 启动服务器，端口设为0自动分配
server_thread = start_http_server(0)
# 获取实际分配的端口
used_port = server_thread.server.server_address[1]

# 停止方式同方案1
server_thread.server.shutdown()
server_thread.join()

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