REDis

2026-07-20 20:55:09 +08:00
parent 52497957f3
commit c31602593a
13 changed files with 453 additions and 31 deletions
@@ -0,0 +1,109 @@
+import assert from 'node:assert/strict';
+import { EventEmitter } from 'node:events';
+import { createRedisCache, withCacheInvalidation } from '../src/cache/redis-cache.mjs';
+
+class FakeRedisClient extends EventEmitter {
+  constructor({ connectError = null } = {}) {
+    super();
+    this.connectError = connectError;
+    this.isOpen = false;
+    this.isReady = false;
+    this.values = new Map();
+  }
+
+  async connect() {
+    if (this.connectError) throw this.connectError;
+    this.isOpen = true;
+    this.isReady = true;
+    this.emit('ready');
+  }
+
+  async get(key) {
+    return this.values.has(key) ? this.values.get(key) : null;
+  }
+
+  async set(key, value, options = {}) {
+    if (options.NX && this.values.has(key)) return null;
+    this.values.set(key, value);
+    return 'OK';
+  }
+
+  async incr(key) {
+    const next = Number(this.values.get(key) || 0) + 1;
+    this.values.set(key, String(next));
+    return next;
+  }
+
+  async quit() {
+    this.isReady = false;
+    this.isOpen = false;
+  }
+
+  destroy() {
+    this.isReady = false;
+    this.isOpen = false;
+  }
+}
+
+const silentLogger = { warn() {} };
+
+{
+  const client = new FakeRedisClient();
+  const cache = await createRedisCache({
+    env: { REDIS_URL: 'redis://test', REDIS_CACHE_PREFIX: 'test', REDIS_CACHE_TTL_SECONDS: '30' },
+    logger: silentLogger,
+    clientFactory: () => client
+  });
+  let loads = 0;
+  const load = async () => ({ version: ++loads });
+
+  assert.deepEqual(await cache.remember('public', 'home', load), { version: 1 });
+  assert.deepEqual(await cache.remember('public', 'home', load), { version: 1 });
+  assert.equal(loads, 1, '相同缓存键应只读取一次数据源');
+
+  await cache.invalidate('public');
+  assert.deepEqual(await cache.remember('public', 'home', load), { version: 2 });
+  assert.equal(loads, 2, '命名空间失效后应重新读取数据源');
+
+  let resultLoads = 0;
+  const loadResults = async () => ({ version: ++resultLoads });
+  assert.deepEqual(await cache.remember('results', 'candidate:1', loadResults), { version: 1 });
+
+  const database = withCacheInvalidation({
+    client: 'test',
+    async read() { return {}; },
+    async save() { return 'saved'; },
+    async close() {}
+  }, cache, method => method === 'save' ? ['public', 'results'] : ['public']);
+  assert.equal(await database.save(), 'saved');
+  assert.deepEqual(await cache.remember('public', 'home', load), { version: 3 });
+  assert.equal(loads, 3, '数据库写入后应让公开缓存失效');
+  assert.deepEqual(await cache.remember('results', 'candidate:1', loadResults), { version: 2 });
+  assert.equal(resultLoads, 2, '成绩相关写入后应让成绩缓存失效');
+  await cache.invalidate('results');
+  assert.deepEqual(await cache.remember('results', 'candidate:1', loadResults), { version: 3 });
+  assert.equal(resultLoads, 3, '后台手动刷新后应重新生成成绩缓存');
+  await cache.close();
+}
+
+{
+  const cache = await createRedisCache({ env: {}, logger: silentLogger });
+  let loads = 0;
+  await cache.remember('public', 'home', async () => ++loads);
+  await cache.remember('public', 'home', async () => ++loads);
+  assert.equal(loads, 2, '未配置 Redis 时应始终回源');
+  assert.equal(cache.status, 'disabled');
+}
+
+{
+  const client = new FakeRedisClient({ connectError: new Error('connection refused') });
+  const cache = await createRedisCache({
+    env: { REDIS_URL: 'redis://unavailable' },
+    logger: silentLogger,
+    clientFactory: () => client
+  });
+  assert.equal(cache.status, 'unavailable');
+  assert.equal(await cache.remember('public', 'home', async () => 'database'), 'database');
+}
+
+console.log('Redis 缓存测试通过');
@@ -89,7 +89,7 @@ await seededTestDatabase.close();

 const server = spawn(process.execPath, ['server.mjs'], {
  cwd: root,
-  env: { ...process.env, NODE_ENV: 'test', DATABASE_CLIENT: 'sqlite', PORT: String(port), SQLITE_PATH: testDb, PUBLIC_SITE_NAME: '环境变量考试中心', PUBLIC_SITE_CODE: 'ENV-TEST', PUBLIC_SITE_PHONE: '0518-1234 5678', PUBLIC_SITE_ADDRESS: '测试地址 1 号', PUBLIC_SITE_EMAIL: 'service@example.test', PUBLIC_SITE_HERO_TITLE: '一次配置，', PUBLIC_SITE_HERO_HIGHLIGHT: '统一首页文案。', PUBLIC_SITE_FOOTER_NOTICE: '环境变量页脚提示' },
+  env: { ...process.env, NODE_ENV: 'test', DATABASE_CLIENT: 'sqlite', REDIS_URL: '', PORT: String(port), SQLITE_PATH: testDb, PUBLIC_SITE_NAME: '环境变量考试中心', PUBLIC_SITE_CODE: 'ENV-TEST', PUBLIC_SITE_PHONE: '0518-1234 5678', PUBLIC_SITE_ADDRESS: '测试地址 1 号', PUBLIC_SITE_EMAIL: 'service@example.test', PUBLIC_SITE_HERO_TITLE: '一次配置，', PUBLIC_SITE_HERO_HIGHLIGHT: '统一首页文案。', PUBLIC_SITE_FOOTER_NOTICE: '环境变量页脚提示' },
  stdio: ['ignore', 'pipe', 'pipe']
 });

@@ -158,6 +158,7 @@ try {
  assert.match(appSource, /data-modal-backdrop/, '弹窗应仅在点击背景层本身时关闭');
  assert.match(appSource, /data-action="edit-exam"/, '考试草稿应提供编辑入口');
  assert.match(appSource, /data-action="archive-exam"/, '超级管理员界面应提供不可逆考试归档入口');
+  assert.match(appSource, /data-action="refresh-results-cache"/, '成绩管理中心应提供 Redis 成绩缓存刷新入口');
  assert.match(appSource, /归档不可撤销/, '归档前应明确提示成绩将永久锁定');

  const { DatabaseSync } = await import('node:sqlite');
@@ -724,6 +725,12 @@ try {
  assert.equal(publishResult.response.status, 200);
  assert.equal((await admin.request('/api/admin/results', { method: 'POST', body: { registrationId, subjectId: exam.subjects[0].id, score: 151, published: true } })).response.status, 400, '成绩不得超过该科配置的满分');
  assert.equal((await admin.request('/api/admin/results', { method: 'POST', body: { registrationId, subjectId: exam.subjects[2].id, score: 90, published: true } })).response.status, 200);
+  const adminResults = await admin.request('/api/admin/results');
+  assert.equal(adminResults.data.resultCache.status, 'disabled', '未配置 REDIS_URL 时成绩管理接口应报告缓存未启用');
+  assert.equal((await schoolAdmin.request('/api/admin/results/cache/refresh', { method: 'POST' })).response.status, 403, '仅超级管理员可以手动刷新成绩缓存');
+  const cacheRefresh = await admin.request('/api/admin/results/cache/refresh', { method: 'POST' });
+  assert.equal(cacheRefresh.response.status, 200, '超级管理员应能调用成绩缓存刷新接口');
+  assert.equal(cacheRefresh.data.refreshed, false, 'Redis 未配置时刷新接口应安全降级为数据库直读');
  const results = await candidate.request('/api/candidate/results');
  assert.ok(results.data.results.some(item => item.score === 126 && item.subjectName === '语文'), '已发布成绩应在考生端可查询');
  const resultSummary = results.data.summaries.find(item => item.examId === exam.id);