---
title: "货币转换器应用如何保持汇率更新？"
description: "货币转换器会保存完整的汇率观测值，按受控周期刷新，并在请求失败或市场关闭时保留数据真实的观测时间。"
canonical: "https://exchangerate.dev/zh/learn/how-currency-converters-update-exchange-rates"
---

# 货币转换器应用如何保持汇率更新？

货币转换器会保存完整的汇率观测值，按受控周期刷新，并在请求失败或市场关闭时保留数据真实的观测时间。

2026年8月23日 · 阅读约8分钟

可靠的转换器不会在每次页面渲染时重新请求一个数字。它会把汇率与 `source`、`market_session`、`data_updated_at` 一起保存，在短时间内复用，并且只在刷新成功后替换。**响应时间表示API何时回答，观测时间表示汇率本身何时变化。**

- 缓存完整观测值，包括 `rates`、`sources`、`market_session` 和 `data_updated_at`。
- 使用 `data_updated_at` 判断数据年龄；`timestamp` 是响应构建时间。
- 活跃汇率可在交易周内日内更新，日参考汇率按自身发布时间更新。
- 周末或市场关闭时，保留最后有效观测值和原始时间。
- 刷新失败时明确显示最后有效值；若没有有效值则返回错误。

## 把整个响应视为一次观测

脱离元数据的汇率含义不完整：它可能是日内现货、每日参考值或推导交叉汇率。因此应保存完整对象，而不是只取出 `rates.EUR`。[API参考](https://exchangerate.dev/zh/docs/api-reference)定义了响应字段，[方法说明](https://exchangerate.dev/methodology)解释了来源和市场状态标签的生成方式。

```jsonabbreviatedlatestresponse title="json · abbreviated latest response"
{
  "base": "USD",
  "source": "live",
  "market_session": "open",
  "timestamp": "2026-08-23T09:42:06Z",
  "data_updated_at": "2026-08-23T09:41:00Z",
  "rates": { "EUR": 0.86124, "GBP": 0.74281 },
  "sources": { "EUR": "live", "GBP": "live" },
  "derived_symbols": []
}
```

`source` 汇总多币种响应中最不及时的数据类别。单个币种应读取 `sources`。`derived_symbols` 标记通过其他币种路径计算出的汇率。

**两个时间，两种含义**

`timestamp` 是API组装响应的时间，`data_updated_at` 是底层观测值写入的时间。展示更新时间和判断新鲜度时应使用后者。

## 先定义刷新政策，再写定时器

不存在适合所有产品的间隔。商店估算价格可共享几分钟缓存，运营面板可在页面可见时刷新，日报可在所需定盘价发布后执行一次。每次渲染都请求不仅浪费调用，也可能得到同一个观测值。

| 用途 | 应用政策 | 界面显示 |
| --- | --- | --- |
| 商店估算 | 共享缓存；每几分钟刷新 | 币种、指示性说明、观测时间 |
| 运营面板 | 短缓存；可见时刷新 | 汇率、来源、市场状态、时间 |
| 日报 | 定盘后定时获取一次 | 汇率与存储的观测时间 |
| 结算金额 | 不使用指示性转换汇率 | 支付或交易服务结果 |

`market_session` 的值为 `open`、`weekend` 或 `interbank_closed`。活跃货币可在交易周内变化，每日参考序列则按自己的发布计划更新。

## 在服务器端建立小型缓存

先对币种排序以生成稳定键，只缓存成功响应，并避免并发刷新重复发出。带密钥的请求必须留在服务器端。

```typescriptlatestratests title="typescript · latest-rates.ts"
type RateSource = "live" | "ecb_daily" | "market_daily";

type LatestRates = {
  base: string;
  source: RateSource;
  sources: Record<string, RateSource>;
  market_session: "open" | "weekend" | "interbank_closed";
  timestamp: string;
  data_updated_at: string;
  rates: Record<string, number>;
  derived_symbols: string[];
};

type CacheEntry = {
  value: LatestRates;
  fetchedAt: number;
};

const cache = new Map<string, CacheEntry>();
const pending = new Map<string, Promise<LatestRates>>();

function cacheKey(base: string, symbols: string[]): string {
  return `${base}:${[...symbols].sort().join(",")}`;
}

async function fetchLatest(base: string, symbols: string[]): Promise<LatestRates> {
  const url = new URL(`https://api.exchangerate.dev/v1/latest/${base}`);
  url.searchParams.set("symbols", [...symbols].sort().join(","));

  const response = await fetch(url, {
    headers: process.env.EXCHANGERATE_API_KEY
      ? { Authorization: `Bearer ${process.env.EXCHANGERATE_API_KEY}` }
      : {},
    signal: AbortSignal.timeout(8000),
  });

  if (!response.ok) {
    throw new Error(`FX refresh failed: ${response.status}`);
  }

  return response.json() as Promise<LatestRates>;
}

export async function getLatestRates(
  base: string,
  symbols: string[],
  maxAgeMs = 60_000,
): Promise<LatestRates> {
  const key = cacheKey(base, symbols);
  const existing = cache.get(key);

  if (existing && Date.now() - existing.fetchedAt < maxAgeMs) {
    return existing.value;
  }

  const inFlight = pending.get(key);
  if (inFlight) return inFlight;

  const refresh = fetchLatest(base, symbols)
    .then((value) => {
      cache.set(key, { value, fetchedAt: Date.now() });
      return value;
    })
    .finally(() => pending.delete(key));

  pending.set(key, refresh);
  return refresh;
}
```

多实例部署应使用共享存储或框架请求缓存。原则不变：数值和观测元数据一起保存，只在成功后替换。

## 刷新错误不是新汇率

超时、429或上游错误并不代表市场有新观测。若产品允许使用最后有效值，应保留原始 `data_updated_at` 并显示回退状态；没有旧数据时直接报错。429应遵守 `Retry-After`，临时错误采用带随机抖动的指数退避，401则需要修正配置。

```typescriptexplicitstalefallback title="typescript · explicit stale fallback"
type ConverterResult =
  | { status: "fresh"; data: LatestRates }
  | { status: "last_known_good"; data: LatestRates; reason: string };

async function getConverterRates(
  base: string,
  symbols: string[],
): Promise<ConverterResult> {
  const key = cacheKey(base, symbols);

  try {
    return { status: "fresh", data: await getLatestRates(base, symbols) };
  } catch (error) {
    const previous = cache.get(key);
    if (!previous) throw error;

    return {
      status: "last_known_good",
      data: previous.value,
      reason: error instanceof Error ? error.message : "Refresh failed",
    };
  }
}
```

对于429响应，应在存在时遵守 `Retry-After`，并避免所有实例同时重试。临时故障可使用带随机抖动的指数退避。认证错误需要修正配置，而不是反复重试。

## 市场关闭是正常状态

周末响应的 `market_session: weekend` 可以合理地携带交易周最后一次观测。不要用新HTTP响应的时间覆盖观测时间，也不要制造周末报价。

市场关闭时，转换器可以延长应用缓存时间，但交易周恢复后仍应刷新。应根据返回的市场状态和产品要求作出决定，不要假设所有货币都遵循同一个时间表。

## 换算后只舍入一次

以USD为基础时，25 USD换算EUR为 `25 × rates.EUR`。保留汇率精度，只按目标币种规则舍入最终金额。

**指示性，不可执行**

转换汇率适合展示、估算和分析。实际扣款金额应由支付或交易服务给出，并包含点差、费用、舍入与执行时间。

## 上线检查清单

- 只请求界面需要的币种。
- 用基础币种与排序后的符号生成缓存键。
- 只缓存完整成功响应，不缓存HTTP错误。
- 合并并发刷新，避免缓存击穿。
- 需要显示数据年龄时使用 `data_updated_at`。
- 保留 `sources`、`market_session` 和 `derived_symbols`。
- API密钥仅放在服务器端。
- 使用最后有效值时保留原始时间并明确标记。

## 常见问题

### 货币转换器应该多久更新一次？

按功能可接受的最大数据年龄设定缓存。务必查看data_updated_at，因为更频繁请求不保证得到新观测。

### 应显示timestamp还是data_updated_at？

显示data_updated_at，它代表底层汇率观测时间。timestamp只是HTTP响应构建时间。

### 市场关闭时怎么办？

保留最后有效观测和原始时间，并显示market_session: weekend或interbank_closed。不要制造更新。

### 刷新失败后可以继续显示旧汇率吗？

可以，但必须明确标记回退状态并保留原始观测时间。若没有旧的有效汇率，则应报错。

## 继续阅读

- [在 Next.js 与 TypeScript 中使用汇率](https://exchangerate.dev/zh/learn/nextjs-typescript-exchange-rates)

Source: https://exchangerate.dev/zh/learn/how-currency-converters-update-exchange-rates
