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

1次阅读

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

最近使用微信小程序开发者工具时，频繁遇到服务端口关闭的错误提示：

22:18:15.461 [微信小程序开发者工具] [error] 工具的服务端口已关闭

这个问题通常出现在以下场景中：

开发者工具长时间闲置未操作
电脑进入休眠或待机状态后恢复
系统资源紧张导致工具异常退出

端口关闭会直接导致：

无法通过命令行调用开发者工具
真机调试功能中断
自动编译和热重载失效
需要手动重新打开工具，打断开发流程

打开微信开发者工具
点击设置 -> 安全设置
勾选 ” 服务端口 ” 选项

这种方式简单直接，但在频繁出现问题时效率低下。

通过 Node.js 脚本自动检测和恢复端口状态，主要实现思路：

检测开发者工具进程状态
解析日志判断端口状态
自动执行命令行开启端口
错误重试和超时处理

以下是完整的 Node.js 自动化脚本：

/**
 * 微信开发者工具端口监控脚本
 * 功能：自动检测和恢复微信开发者工具的服务端口状态
 */
const {execSync} = require('child_process');
const ps = require('ps-node');
const fs = require('fs');
const path = require('path');

// 配置参数
const CONFIG = {
  maxRetries: 3,          // 最大重试次数
  retryInterval: 2000,    // 重试间隔 (ms)
  timeout: 10000,         // 超时时间 (ms)
  logPath: path.join(process.env.HOME, 'Library/Application Support/ 微信开发者工具 /Default/.ide') // macOS 日志路径
};

/**
 * 检查端口状态
 */
function checkPortStatus() {
  try {
    // 检查开发者工具进程是否运行
    const isRunning = new Promise((resolve) => {ps.lookup({ command: '微信开发者工具'}, (err, result) => {resolve(!!(result && result.length > 0));
      });
    });

    if (!isRunning) {console.log('开发者工具未运行');
      return false;
    }

    // 检查日志中是否有端口关闭错误
    const logFiles = fs.readdirSync(CONFIG.logPath).filter(f => f.endsWith('.log'));
    const latestLog = path.join(CONFIG.logPath, logFiles.sort().reverse()[0]);
    const logContent = fs.readFileSync(latestLog, 'utf-8');

    return logContent.includes('工具的服务端口已关闭');
  } catch (error) {console.error('检查端口状态失败:', error);
    return false;
  }
}

/**
 * 开启服务端口
 */
function enableServicePort(retryCount = 0) {
  try {
    execSync('cli --open', { 
      timeout: CONFIG.timeout,
      stdio: 'inherit'
    });
    console.log('服务端口开启成功');
    return true;
  } catch (error) {if (retryCount < CONFIG.maxRetries) {console.log(` 尝试 ${retryCount + 1}/${CONFIG.maxRetries} 失败，准备重试...`);
      setTimeout(() => enableServicePort(retryCount + 1), CONFIG.retryInterval);
    } else {console.error('开启服务端口失败:', error);
      return false;
    }
  }
}

// 主流程
function main() {if (checkPortStatus()) {console.log('检测到服务端口已关闭，尝试恢复...');
    enableServicePort();} else {console.log('服务端口状态正常');
  }
}

// 启动监控
main();

在构建脚本前添加端口检查
失败时自动重试或通知开发者

# 示例 GitLab CI 配置
stages:
  - prepare
  - build

check_port:
  stage: prepare
  script:
    - node check-wechat-port.js

build:
  stage: build
  needs: ["check_port"]
  script:
    - npm run build