如何为安卓应用Userbook更换API基础URL并保持向后兼容？

一、后端(Node.js)配置：兼容旧URI请求 #

旧版本Android应用仍会向https://userbook.com/api/发起请求，需在Node.js服务中添加转发或重定向逻辑，确保这些请求能被新API正常处理：

1. Express请求转发方案（推荐） #

如果后端基于Express框架，可通过代理中间件将旧URI请求转发到新地址，对旧客户端完全透明：

const express = require('express');
const { createProxyMiddleware } = require('http-proxy-middleware');
const app = express();

// 代理旧API路径请求到新域名
app.use('/api', createProxyMiddleware({
  target: 'https://api.userbook.com/',
  changeOrigin: true,
  pathRewrite: {
    '^/api': '' // 新URI无/api后缀，移除原路径的/api前缀
  }
}));

// 原有业务路由代码
// ...

app.listen(3000);

2. 重定向方案 #

若无需代理，可返回301/302重定向响应，引导客户端跳转到新URI：

app.use('/api', (req, res) => {
  const newUrl = `https://api.userbook.com/${req.url.replace(/^\/api/, '')}`;
  res.redirect(301, newUrl); // 301为永久重定向，302为临时重定向
});

注意：部分旧版本Android网络库可能存在重定向兼容问题，需提前测试。

二、Android新版本应用更新 #

在新版本Userbook中直接替换API基础URI：

• 找到项目中配置API地址的常量文件（如ApiConstants.kt或ApiConstants.java）
• 修改基础地址：

// Kotlin示例
object ApiConstants {
    const val BASE_URL = "https://api.userbook.com/"
}

// Java示例
public class ApiConstants {
    public static final String BASE_URL = "https://api.userbook.com/";
}

完成后发布新版本到Play Store，引导用户升级。

三、过渡期间兼容性保障 #

1. 延长旧URI支持周期：根据Play Store活跃用户数据，保留旧URI的转发/重定向逻辑至少3个月，确保90%以上用户完成升级后再考虑移除。
2. 监控请求数据：在后端添加日志统计旧URI的请求量，判断用户升级进度：

app.use('/api', (req, res, next) => {
  console.log(`[旧URI请求] ${new Date().toISOString()} - ${req.method} ${req.originalUrl}`);
  next();
});

3. 兼容接口变更：若新URI下部分接口的参数或响应格式有调整，需在后端做兼容处理，确保旧客户端的请求无论通过旧URI代理还是新URI访问，都能返回预期结果。

四、验证方案 #

• 旧版本应用验证：安装未更新的旧版本Userbook，测试登录、数据同步等核心功能，确认通过旧URI可正常交互。
• 新版本应用验证：安装新版本应用，全量测试功能，确认新URI可正常工作。
• 转发/重定向逻辑验证：通过curl或Postman测试旧URI请求，确认能正确转发或跳转到新URI并返回有效响应：

curl -v https://userbook.com/api/users/1
# 预期：返回代理后的业务响应，或跳转到https://api.userbook.com/users/1

内容的提问来源于stack exchange，提问作者Edward Snowden