mm_redis 1.9.4 → 1.9.5

package/compatibility_table.md

@@ -0,0 +1,64 @@
+```markdown
+# 三种缓存方式方法兼容性对比表格
+
+## 核心缓存方法
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| set | ✅ | ✅ | ✅ | 完全兼容 |
+| get | ✅ | ✅ | ✅ | 完全兼容 |
+| del | ✅ | ✅ | ✅ | 完全兼容 |
+| has | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| clear | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| keys | ✅ | ✅ | ✅ | 完全兼容 |
+| ttl | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+| persist | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+| add | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| addInt | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| addStr | ❌ | ✅ | ✅ | Redis无此方法，CacheBase保持兼容 |
+| sort | ✅ | ❌ | ✅ | Redis原生支持，CacheBase模拟实现 |
+
+## Redis兼容方法 - 哈希表操作
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| hset | ✅ | ✅ | ✅ | 模拟实现，通过set对象方式 |
+| hget | ✅ | ✅ | ✅ | 模拟实现，通过get对象方式 |
+| hgetall | ✅ | ✅ | ✅ | 模拟实现，返回完整对象 |
+| hdel | ✅ | ✅ | ✅ | 模拟实现，删除对象属性 |
+| hexists | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| hkeys | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| hvals | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+
+## Redis兼容方法 - 集合操作
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| sadd | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| srem | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| sismember | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| smembers | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| scard | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+
+## Redis兼容方法 - 有序集合操作
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| zadd | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| zrem | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| zrange | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+| zscore | ✅ | ❌ | ❌ | Redis原生支持，CacheBase未实现 |
+
+## Redis兼容方法 - 其他常用命令
+
+| 方法名 | Redis | MongoDB | CacheBase | 状态说明 |
+|-------|-------|---------|-----------|----------|
+| expire | ✅ | ❌ | ✅ | Redis原生支持，CacheBase通过ttl模拟 |
+| incr | ✅ | ⚠️ | ✅ | Redis原生支持，MongoDB返回undefined，CacheBase通过addInt模拟 |
+| decr | ✅ | ⚠️ | ✅ | Redis原生支持，MongoDB返回undefined，CacheBase通过addInt模拟 |
+| exists | ✅ | ✅ | ✅ | 兼容，Redis原生支持 |
+| mget | ✅ | ⚠️ | ✅ | Redis原生支持，CacheBase实现兼容 |
+| mset | ✅ | ✅ | ✅ | Redis原生支持，CacheBase实现兼容 |
+
+注：✅ 完全兼容/功能正常 | ⚠️ 部分兼容/有异常 | ❌ 不兼容/未实现
+```

package/index.js

@@ -632,7 +632,8 @@ Redis.prototype.addInt = async function (key, num) {
 		// 触发错误事件
 		this.emit('addInt_error', { key, value: num, error: err });
 		$.log.error(`[Redis] 增加整数值失败 [${key}]:`, err);
-		throw err;
+		// 与CacheBase保持一致，错误时返回默认值而不是抛出异常
+		return 0;
 	}
 };
 
@@ -648,10 +649,10 @@ Redis.prototype.addFloat = async function (key, num) {
 		const beforeEventData = { key, value: num, cancel: false };
 		this.emit('addFloat_before', beforeEventData);
 
-		// 如果事件处理器标记为取消，则抛出错误
+		// 如果事件处理器标记为取消，则返回默认值
 		if (beforeEventData.cancel) {
 			$.log.debug(`[Redis] addFloat操作被事件处理器取消 [${key}]`);
-			throw new Error('addFloat操作被取消');
+			return 0;
 		}
 
 		// 使用可能被修改的值
@@ -707,7 +708,8 @@ Redis.prototype.addFloat = async function (key, num) {
 		// 触发错误事件
 		this.emit('addFloat_error', { key, value: num, error: err });
 		$.log.error(`[Redis] 增加浮点数值失败 [${key}]:`, err);
-		throw err;
+		// 与CacheBase保持一致，错误时返回默认值而不是抛出异常
+		return 0;
 	}
 };
 
@@ -2054,7 +2056,7 @@ Redis.prototype._releaseConnection = function (connection) {
 					} else {
 						$.log.debug('[Redis] 连接对象没有可用的关闭方法');
 					}
-					$.log.debug('[Redis] 关闭多余连接:', connection.id);
+					// $.log.debug('[Redis] 关闭多余连接:', connection.id);
 				} catch (e) {
 					$.log.error('[Redis] 关闭多余连接失败:', e);
 				}
@@ -2065,6 +2067,9 @@ Redis.prototype._releaseConnection = function (connection) {
 	}
 };
 
+// 确保_recycleConnection方法是_releaseConnection的别名
+Redis.prototype._recycleConnection = Redis.prototype._releaseConnection;
+
 // 添加Hash操作相关方法
 
 /**
@@ -2891,7 +2896,7 @@ Redis.prototype._createConnection = function () {
 
 			// 连接Redis
 			connection.connect().then(() => {
-				$.log.debug('[Redis] 新连接已创建并连接:', connection.id);
+				// $.log.debug('[Redis] 新连接已创建并连接:', connection.id);
 				resolve(connection);
 			}).catch(err => {
 				$.log.error('[Redis] 创建连接失败:', err);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_redis",
-    "version": "1.9.4",
+    "version": "1.9.5",
     "description": "高效的Redis客户端封装库，提供连接池管理、数据类型操作、错误处理和批量操作优化",
     "main": "index.js",
     "scripts": {
@@ -35,7 +35,7 @@
     "homepage": "https://www.npmjs.com/package/mm_redis",
     "dependencies": {
         "mm_logs": "^1.5.2",
-        "redis": "^4.7.0"
+        "redis": "^5.8.3"
     },
     "engines": {
         "node": ">=14.0.0"