路由重定向的实现方式

路由重定向的实现方式

路由重定向是Web开发中常见的需求，Koa2提供了多种方式来实现这一功能。无论是简单的路径跳转还是复杂的条件重定向，都能通过中间件和上下文对象轻松完成。

使用ctx.redirect方法

Koa2的上下文对象提供了直接的redirect方法，这是最基础的重定向实现方式：

router.get('/old', async (ctx) => {
  ctx.redirect('/new');
});

router.get('/new', async (ctx) => {
  ctx.body = 'This is the new page';
});

redirect方法默认使用302状态码，也可以显式指定状态码：

ctx.redirect('/permanent', 301);

通过中间件实现全局重定向

可以创建自定义中间件来处理特定路由的重定向逻辑：

async function redirectMiddleware(ctx, next) {
  if (ctx.path === '/deprecated') {
    return ctx.redirect('/current');
  }
  await next();
}

app.use(redirectMiddleware);

动态路径重定向

重定向目标可以是动态生成的：

router.get('/user/:id', async (ctx) => {
  const userId = ctx.params.id;
  if (!isValidUser(userId)) {
    ctx.redirect('/error/invalid-user');
  } else {
    await next();
  }
});

条件重定向

根据请求参数或头信息进行条件重定向：

router.get('/content', async (ctx) => {
  const userAgent = ctx.headers['user-agent'];
  if (userAgent.includes('Mobile')) {
    ctx.redirect('/mobile/content');
  } else {
    ctx.redirect('/desktop/content');
  }
});

使用koa-router的all方法

对于需要处理所有HTTP方法的路由重定向：

router.all('/legacy', async (ctx) => {
  ctx.redirect('/modern');
});

重定向到外部URL

redirect方法也支持完整的URL重定向：

router.get('/external', async (ctx) => {
  ctx.redirect('https://example.com');
});

重定向链的处理

要避免重定向循环，可以设置最大重定向次数：

let redirectCount = 0;
const MAX_REDIRECTS = 5;

app.use(async (ctx, next) => {
  if (redirectCount >= MAX_REDIRECTS) {
    ctx.status = 508;
    ctx.body = 'Loop Detected';
    return;
  }
  redirectCount++;
  await next();
  redirectCount--;
});

重定向前的数据处理

在重定向前可以操作上下文数据：

router.get('/transfer', async (ctx) => {
  ctx.session.referrer = ctx.path;
  ctx.redirect('/new-location');
});

使用正则表达式匹配重定向

对于复杂的路由模式匹配：

app.use(async (ctx, next) => {
  const oldPattern = /^\/blog\/posts\/(\d+)$/;
  const match = ctx.path.match(oldPattern);
  if (match) {
    const postId = match[1];
    return ctx.redirect(`/articles/${postId}`);
  }
  await next();
});

重定向与RESTful API

在API设计中处理资源移动：

router.get('/api/v1/users', async (ctx) => {
  ctx.status = 301;
  ctx.set('Location', '/api/v2/members');
  ctx.body = {
    message: 'Resource permanently moved'
  };
});

测试重定向

编写测试用例验证重定向行为：

const request = require('supertest');
const app = require('../app');

describe('Redirect tests', () => {
  it('should redirect /old to /new', async () => {
    const res = await request(app)
      .get('/old')
      .expect(302)
      .expect('Location', '/new');
  });
});

性能考虑

频繁重定向会影响性能，可以通过缓存优化：

router.get('/cached-redirect', async (ctx) => {
  ctx.set('Cache-Control', 'public, max-age=3600');
  ctx.redirect('/target');
});

安全注意事项

验证重定向目标防止开放重定向漏洞：

const safeRedirect = (url) => {
  if (!url.startsWith('/') && !url.startsWith('http://example.com')) {
    throw new Error('Unsafe redirect attempt');
  }
  return url;
};

router.get('/safe-redirect', async (ctx) => {
  const target = ctx.query.url;
  ctx.redirect(safeRedirect(target));
});

与前端路由的配合

处理前后端路由的协调：

router.get('*', async (ctx) => {
  if (!ctx.path.startsWith('/api')) {
    ctx.redirect('/app' + ctx.path);
  } else {
    await next();
  }
});

重定向日志记录

记录重定向事件用于分析：

app.use(async (ctx, next) => {
  const start = Date.now();
  await next();
  if ([301, 302, 303, 307, 308].includes(ctx.status)) {
    console.log(`Redirect: ${ctx.method} ${ctx.path} -> ${ctx.get('Location')} in ${Date.now() - start}ms`);
  }
});

处理POST请求的重定向

POST请求后的重定向模式（PRG模式）：

router.post('/submit-form', async (ctx) => {
  // 处理表单数据
  ctx.redirect('/success');
});

router.get('/success', async (ctx) => {
  ctx.body = 'Form submitted successfully';
});

多语言站点的重定向

基于用户语言首选项的重定向：

router.get('/', async (ctx) => {
  const lang = ctx.acceptsLanguages('en', 'zh') || 'en';
  ctx.redirect(`/${lang}/home`);
});