微信小程序开发者工具端口关闭问题全解析：从报错到修复的实战指南

1次阅读

共计 1554 个字符，预计需要花费 4 分钟才能阅读完成。

当你启动微信小程序开发者工具时，可能会遇到这样的报错：

[微信小程序开发者工具][error] 工具的服务端口已关闭。要使用命令行调用工具，请...

微信小程序开发者工具采用客户端 - 服务端架构，通过本地 TCP 端口进行通信。默认情况下，工具会监听以下端口：

主服务端口：通常为 80 或443
调试端口：范围在 1024-65535 之间

netstat -ano | findstr "端口号"

lsof -i : 端口号

Windows: 使用 tasklist 和taskkill
macOS: 使用 ps 和kill

首先检测端口占用情况

Windows:

netstat -ano | findstr "端口号"

macOS/Linux:

lsof -i : 端口号

结束占用进程

Windows:

taskkill /F /PID 进程 ID

macOS/Linux:

kill -9 进程 ID

重启开发者工具

Python 版本:

import os
import sys
import socket
from subprocess import call

# 检测端口是否被占用
def is_port_in_use(port):
    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
        return s.connect_ex(('localhost', port)) == 0

# 主函数
def main():
    port = 80  # 默认端口
    if is_port_in_use(port):
        print(f"端口 {port} 被占用，尝试释放...")
        # 这里添加释放端口的代码
    else:
        print("端口正常，可以启动开发者工具")

if __name__ == "__main__":
    main()

Bash 版本:

#!/bin/bash

PORT=80

# 检测端口是否被占用
if lsof -i :$PORT > /dev/null; then
    echo "端口 $PORT 被占用，尝试释放..."
    # 这里添加释放端口的代码
else
    echo "端口正常，可以启动开发者工具"
fi

常用参数：

cli --auto-port  # 自动分配端口
cli --port 8080  # 指定端口
cli --reset      # 重置工具

在项目根目录添加 .git/hooks/pre-commit 钩子，检测端口冲突：

#!/bin/bash

PORT=80
if lsof -i :$PORT > /dev/null; then
    echo "错误：端口 $PORT 被占用，请先释放"
    exit 1
fi

使用 pm2 配置示例：

module.exports = {
  apps: [{
    name: 'wechat-dev-tools',
    script: 'cli',
    args: '--auto-port',
    autorestart: true,
    watch: false,
    max_memory_restart: '1G',
    env: {NODE_ENV: 'development'}
  }]
}

通过本文，你应该已经掌握了解决微信小程序开发者工具端口关闭问题的方法。从基本的端口检测到自动化脚本，再到工程化实践，我们一步步深入了解了这个常见问题的解决方案。