微信小程序开发者工具端口关闭问题解析与命令行调用解决方案

1次阅读

没有评论

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

微信小程序开发者工具默认通过服务端口提供命令行调用能力。当出现 ” 工具的服务端口已关闭 ” 提示时，通常由以下原因导致：

开发者工具非正常退出（如强制结束进程）
系统防火墙 / 安全软件拦截
端口被其他进程占用（默认端口为 9420）
工具版本升级后的配置重置

影响范围：

无法通过 cli 命令进行项目初始化、预览、上传等操作
自动化构建流程中断
CI/CD 管道失败

确保开发者工具已安装（建议 v1.05.2103200+ 版本）
启动开发者工具 GUI 界面
顶部菜单选择设置 > 安全设置
勾选 ” 服务端口 ” 区域的 ” 开启 ” 选项
点击确认保存设置

验证端口状态：

telnet 127.0.0.1 9420  # 成功连接即表示端口已开放

将开发者工具安装目录加入 PATH（默认路径示例）：

# macOS/Linux
export PATH=$PATH:"/Applications/wechatwebdevtools.app/Contents/MacOS"

# Windows
set PATH=%PATH%;"C:\Program Files (x86)\Tencent\ 微信 web 开发者工具"

测试命令行调用：

cli -l # 列出项目
cli -p /project/path --upload # 上传项目

import os
import socket
import subprocess

def check_port(port=9420):
    """检测端口是否可用"""
    try:
        with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
            return s.connect_ex(('localhost', port)) == 0
    except Exception as e:
        print(f"Port check failed: {e}")
        return False

def start_devtools():
    """启动开发者工具并确保端口开放"""
    # Windows 示例路径，需根据实际安装位置调整
    tool_path = r"C:\Program Files (x86)\Tencent\ 微信 web 开发者工具 \ 微信 web 开发者工具.exe"
    if not os.path.exists(tool_path):
        raise FileNotFoundError("DevTools not found at default location")

    subprocess.Popen([tool_path, "--start"])  # 无 GUI 启动

    # 等待端口就绪（最长 30 秒）for _ in range(30):
        if check_port():
            print("DevTools service port is ready")
            return True
        time.sleep(1)

    print("Failed to start service port")
    return False

#!/bin/bash

PORT=9420
TOOL_PATH="/Applications/wechatwebdevtools.app/Contents/MacOS/cli"

# 检查端口状态
check_port() {nc -z 127.0.0.1 $PORT && return 0 || return 1}

# 启动工具
if ! check_port; then
    nohup "$TOOL_PATH" --start &> /dev/null &

    # 等待端口激活
    for i in {1..30}; do
        check_port && break
        sleep 1
        [$i -eq 30] && echo "Timeout waiting for port" && exit 1
    done
fi

echo "Service port is active"

端口冲突：
解决方案：修改默认端口号（开发者工具设置→安全设置→自定义端口）
验证命令：lsof -i :9420
权限不足：
现象：无法保存设置或启动服务
解决方案：
- macOS/Linux：使用 sudo 执行
- Windows：以管理员身份运行开发者工具
防火墙拦截：
操作步骤：
- Windows：控制面板→Windows Defender 防火墙→允许应用通过防火墙
- macOS：系统偏好设置→安全性与隐私→防火墙→防火墙选项
版本兼容性问题：
建议始终使用稳定版工具
检查更新：开发者工具→关于→检查更新

Jenkins Pipeline 示例：

pipeline {
    agent any
    stages {stage('Setup DevTools') {
            steps {
                script {
                    // 确保工具已安装
                    def toolPath = tool name: 'wechat-devtools', type: 'com.cloudbees.jenkins.plugins.customtools.CustomTool'

                    // 启动服务端口
                    bat "${toolPath}\\cli.exe --start"

                    // 等待端口就绪
                    timeout(time: 1, unit: 'MINUTES') {
                        waitUntil {def rc = bat(script: "netstat -ano | findstr :9420", returnStatus: true)
                            return rc == 0
                        }
                    }
                }
            }
        }
        stage('Build') {
            steps {bat "${toolPath}\\cli.exe -p ${WORKSPACE} --upload"
            }
        }
    }
}

GitHub Actions 集成：

name: WeChat MiniProgram CI

on: [push]

jobs:
  build:
    runs-on: macOS-latest
    steps:
    - uses: actions/checkout@v2

    - name: Start DevTools
      run: |
        /Applications/wechatwebdevtools.app/Contents/MacOS/cli --start
        sleep 10  # 等待服务初始化

    - name: Upload Project
      run: |
        /Applications/wechatwebdevtools.app/Contents/MacOS/cli \
          -p $GITHUB_WORKSPACE \
          --upload \
          --version ${{github.sha}} \
          --desc "Auto deploy from GitHub Actions"