Node.js 连接 Memcached 实战：快速设置 aiQueueRun 键值 附完整可运行代码
在后端开发过程中，我们经常会用到 Memcached 作为缓存服务，来缓解数据库压力、提升服务响应速度。最近在开发过程中，需要通过 Node.js 连接 Memcached 服务，并设置特定键值 aiQueueRun = 1，用于控制 AI 任务队列的运行状态。结合实际开发场景，整理了一套完整的实现方案，包含依赖安装、代码实现、连接测试及关键注意事项，直接复制即可投入生产使用。
一、环境准备：安装 Memcached 客户端依赖
Node.js 连接 Memcached 需借助第三方客户端库，这里选用官方推荐、社区活跃度高的 memcached 库，该库 API 简洁、稳定性强，能满足日常开发中的缓存操作需求。
打开终端，执行以下命令安装依赖：
npm install memcached --save安装完成后，即可在项目中引入该库，进行 Memcached 连接和操作。
二、完整可运行代码：连接 Memcached 并设置 aiQueueRun = 1
以下代码包含了 Memcached 连接创建、连接状态检测、键值设置、值验证及连接关闭的完整流程，适配本地和远程 Memcached 服务，可根据实际部署情况灵活修改。
// 引入 Memcached 库
const Memcached = require('memcached');
// 1. 创建连接（默认本地 Memcached 地址：localhost:11211）
// 若为远程服务器，替换为实际 IP:端口，例如 '192.168.1.100:11211'
const memcached = new Memcached('localhost:11211', {
retries: 1, // 连接失败重试次数
retry: 1000, // 重试间隔时间（毫秒）
timeout: 1000 // 连接超时时间（毫秒）
});
// 2. 测试连接是否成功
memcached.connect('localhost:11211', function(err) {
if (err) {
console.error('Memcached 连接失败:', err);
return;
}
console.log('✅ Memcached 连接成功');
// 3. 设置 key = aiQueueRun，value = 1，过期时间 0（永久有效）
memcached.set('aiQueueRun', 1, 0, function(err) {
if (err) {
console.error('❌ aiQueueRun 键值设置失败:', err);
} else {
console.log('✅ 成功设置 aiQueueRun = 1');
// 可选：验证键值设置是否成功
memcached.get('aiQueueRun', function(err, data) {
console.log('📋 当前 aiQueueRun 的值：', data);
// 用完关闭连接（可选，根据业务场景决定是否长期保持连接）
memcached.end();
});
}
});
});三、关键 API 及参数说明
在上述代码中，核心用到了 Memcached 客户端的 connect、set、get、end 四个方法，重点说明关键参数和使用场景，帮助大家理解代码逻辑，避免踩坑。
1. 连接创建参数
创建 Memcached 实例时，第二个参数为配置对象，常用参数如下：
- retries：连接失败后的重试次数，建议设置为 1-3 次，避免过度重试导致服务压力；
- retry：重试间隔时间（毫秒），设置为 1000ms 即可，间隔过短可能导致多次无效重试；
- timeout：连接超时时间（毫秒），超过该时间未连接成功则判定为失败，根据网络环境调整，一般设置 1000-3000ms。
2. set 方法详解
set 方法用于向 Memcached 中设置键值对，语法如下：
memcached.set(key, value, expires, callback)各参数说明：
- key：需要设置的键名，此处为 aiQueueRun；
- value：键对应的值，此处为 1（支持字符串、数字等基础类型）；
- expires：过期时间（单位：秒），0 表示永久不过期，根据业务需求设置，例如 3600 表示 1 小时后过期；
- callback：回调函数，用于处理设置成功或失败的逻辑，err 为错误信息，无错误则为 null。
3. 可选操作说明
代码中添加了 get 方法用于验证键值设置是否成功，实际开发中可根据需求选择是否保留；end 方法用于关闭 Memcached 连接，若项目中需要长期使用缓存连接，可省略该方法，避免频繁创建和关闭连接带来的性能损耗。
四、常见问题排查
在实际部署过程中，可能会遇到 Memcached 连接失败或键值设置失败的情况，总结以下 3 个常见问题及排查方向，帮助快速定位问题：
- Memcached 服务未启动：检查本地或远程服务器上的 Memcached 服务是否正常运行，可通过命令
systemctl status memcached（Linux）或服务管理器（Windows）查看； - 连接地址或端口错误：确认 Memcached 服务的 IP 地址和端口是否正确，默认端口为 11211，若修改过端口需对应调整代码中的连接地址；
- 防火墙拦截：检查服务器防火墙是否放行 11211 端口，若为远程连接，需在防火墙中开放该端口，避免连接被拦截。
五、总结
本文通过实际开发场景，完整实现了 Node.js 连接 Memcached 并设置 aiQueueRun = 1 的功能，包含依赖安装、代码实现、API 说明及问题排查，代码可直接复制运行，适配大多数后端开发场景。Memcached 作为轻量级缓存服务，在缓解高并发压力、提升服务性能方面有着广泛的应用，掌握 Node.js 与 Memcached 的连接和基础操作，能有效提升后端开发效率。
