微信小程序开发者工具端口关闭问题全解析：从错误排查到自动化解决方案

1次阅读

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

当你在终端运行微信小程序开发者工具的命令行操作时，可能会遇到这样的错误提示：

22:18:15.461 [微信小程序开发者工具] [error] 工具的服务端口已关闭。要使用命令行调用工具，请在下方输入 y 以确认开启，或手动打开工具 -> 设置 -> 安全设置，将服务端口开启。

这个错误意味着开发者工具的服务端口没有开启，导致无法通过命令行与工具进行通信。这种情况通常发生在以下几种场景：

首次使用命令行调用开发者工具
开发者工具更新后重置了设置
系统安全策略自动关闭了端口

端口关闭会直接影响开发流程，特别是当你依赖命令行工具进行以下操作时：

自动化构建和部署
CI/CD 流程中的小程序打包
批量处理多个小程序项目

这是最直接的方法，适合偶尔使用命令行或对自动化要求不高的开发者：

打开微信开发者工具
点击顶部菜单的 ” 设置 ”
选择 ” 安全设置 ”
找到 ” 服务端口 ” 选项并开启
关闭并重新打开开发者工具使设置生效

优点：操作简单直观，不需要技术背景
缺点：每次环境变化都需要手动操作，不适合自动化流程

对于需要频繁使用命令行或集成到 CI/CD 流程中的开发者，自动化方案更为高效。基本思路是：

检测服务端口状态
自动发送确认指令 ’y’
处理可能的错误和重试

优点：一次配置，长期有效；适合自动化环境
缺点：需要一定的脚本编写能力；可能涉及权限问题

下面是一个 Node.js 自动化脚本示例，可以自动处理端口关闭问题：

const {exec} = require('child_process');
const readline = require('readline');

// 微信开发者工具命令路径
const CLI_PATH = '/Applications/wechatwebdevtools.app/Contents/MacOS/cli';

// 要执行的小程序命令
const PROJECT_PATH = './';
const COMMAND = `--upload ${PROJECT_PATH} --version 1.0.0 --desc 'auto deploy'`;

function runWithPortCheck(maxRetries = 3) {
  let retries = 0;

  const execute = () => {const child = exec(`${CLI_PATH} ${COMMAND}`);

    // 创建接口监听子进程输出
    const rl = readline.createInterface({
      input: child.stdout,
      output: child.stdin,
      terminal: true
    });

    // 监听端口关闭提示
    rl.on('line', (line) => {if (line.includes('服务端口已关闭')) {
        // 自动发送 'y' 确认开启端口
        child.stdin.write('y\n');
      }
    });

    child.on('exit', (code) => {if (code !== 0 && retries < maxRetries) {
        retries++;
        console.log(` 尝试 ${retries}/${maxRetries}...`);
        execute();} else if (code !== 0) {console.error('失败: 超过最大重试次数');
        process.exit(1);
      }
    });
  };

  execute();}

runWithPortCheck();

脚本关键点说明：