目录

exp

先说结论:exp 是一个高度依赖语境的缩写。代码里最常见的两个意思是 —— 令牌里的「过期时间」claim(expiration time),和 数学里的指数函数 ex。此外它还能表示 export(导出)、expiry(有效期)、exponent(阶码 / 指数)、experience(经验值)、expression(表达式)。

判断方法很简单:看它出现的位置、看它的值长什么样。

1. 几种含义速览

语境 含义 典型长相
JWT / OAuth 令牌 expiration time,过期时间 数字:1700003600(Unix 秒)
数学 / 科学计算 指数函数,e 的 x 次方 exp(1) = 2.718…
浮点 / 汇编 exponent,阶码 IEEE 754 的 8 位 / 11 位阶码字段
数据库 / 运维 export,导出工具 命令:exp、expdp
构建产物 链接器生成的导出文件 文件:foo.exp(与 foo.lib 同出)
支付 / 表单 expiry,有效期 EXP 12/28 或 MM/YY
游戏 / 激励系统 experience,经验值 EXP +120
编译原理 expression,表达式 文法里的非终结符 exp
一句话判据:**后面跟 Unix 时间戳 → 令牌过期;出现在数值库或数学表达式里 → 指数函数;出现在命令行或文件名里 → 导出。**

2. JWT 里的 ''exp'':过期时间

JWT 由三段拼成:header.payload.signature。exp 就住在中间那段 payload(claims,声明)里(payload 的结构见 payload):

{
  "sub": "1234567890",
  "iat": 1700000000,
  "exp": 1700003600        // ← 这串数字就是过期时间
}

2.1 规范怎么定义

exp 是 RFC 7519 定义的 Registered Claim(注册声明名),全称 expiration time:

2.2 与它一起出现的时间类 claim

claim 全称 含义 校验方向
exp expiration time 过期时刻 当前时间必须早于它
nbf not before 生效时刻 当前时间必须晚于 / 等于它
iat issued at 签发时刻 判断令牌年龄,配合 maxAge 使用
jti JWT ID 令牌唯一标识 配合黑名单实现撤销

2.3 校验时真正发生的事

if (now - leeway >= exp)   reject("token expired")
if (nbf && now + leeway < nbf)   reject("token not active")

2.4 生成与校验的代码

// jose:用人类可读的时长,别手算时间戳
import { SignJWT, jwtVerify } from "jose";
 
const token = await new SignJWT({ role: "admin" })
  .setProtectedHeader({ alg: "HS256" })
  .setSubject("user-42")
  .setIssuedAt()
  .setExpirationTime("15m")            // 15 分钟后过期
  .sign(secret);
 
try {
  const { payload } = await jwtVerify(token, secret, {
    clockTolerance: 30,                // 允许 30 秒时钟偏移
    issuer: "https://auth.example.com",
    audience: "api",
  });
} catch (e) {
  // e.code === "ERR_JWT_EXPIRED"
}
// jsonwebtoken:注意 expiresIn 是「相对时长」,别和绝对时间戳混用
import jwt from "jsonwebtoken";
 
const token = jwt.sign({ sub: "user-42" }, secret, { expiresIn: "15m" });
jwt.verify(token, secret, { clockTolerance: 30 });   // 过期抛 TokenExpiredError
// 危险:ignoreExpiration: true 会跳过 exp 校验,生产环境绝不要开
# PyJWT:同样支持 leeway,并可用 require 强制 exp 必须存在
import datetime
import jwt
 
token = jwt.encode(
    {
        "sub": "user-42",
        "exp": datetime.datetime.now(datetime.timezone.utc)
               + datetime.timedelta(minutes=15),
    },
    secret,
    algorithm="HS256",
)
jwt.decode(token, secret, algorithms=["HS256"], leeway=30,
           options={"require": ["exp"]})

2.5 手工看一眼 ''exp''

# 只解码中间那段 payload(base64url)
echo "$TOKEN" | cut -d. -f2 | tr '_-' '/+' | base64 -d 2>/dev/null
 
# 用 node 一步读出并转成可读时间
node -e "const p=JSON.parse(Buffer.from(process.argv[1].split('.')[1],'base64url'));console.log(p.exp, new Date(p.exp*1000).toISOString())" "$TOKEN"

注意:这只是解码,不是验证。JWS 只签名不加密,payload 谁都能读(详见 payload 与 hex),所以手工读出来的 exp 只能用于排查问题,不能当安全保证。

2.6 常见坑

现象 原因 处理方向
令牌「几万年后才过期」或「刚发就过期」 把毫秒时间戳(Date.now())当秒写进 exp 统一用秒:Math.floor(Date.now()/1000)
换个环境就大量 401 服务器之间时钟不同步 上 NTP,并设置 30–60 秒 leeway
前端判断未过期,后端却拒绝 只在客户端校验 exp 前端解码只做 UX(提前刷新),安全边界必须在服务端
以为短 exp 就等于能撤销 exp 到期前令牌始终有效 配黑名单、jti,或短有效期 + refresh token
exp 校验直接报格式错误 写成了日期字符串而非 NumericDate 一律写秒级时间戳
换语言/换库后行为不一致 宽松库自动把字符串数字转数字,严格库直接拒绝 签发端就规范成数字,别依赖库的容错
业务到期时间被塞进 exp 混用两种「过期」语义 业务有效期另放自定义 claim

3. 数学里的 ''exp'':指数函数

exp 是 exponential(指数函数) 的缩写:exp(x) = ex,其中 e 是自然常数 ≈ 2.718281828459045。它是自然对数 ln 的反函数:

exp(0) = 1              ln(1) = 0
exp(1) = e ≈ 2.71828
exp(-∞) → 0             exp(+∞) → +∞
exp(ln x) = x           (x > 0)
exp(a + b) = exp(a) · exp(b)

各语言里基本都叫 exp:

import math
 
math.exp(1)      # 2.718281828459045
math.exp(709)    # 8.2e307,还在 double 范围内
math.exp(710)    # OverflowError: math range error(双精度上限 ≈ 709.78)
math.exp(-746)   # 0.0,下溢
math.expm1(1e-9) # exp(x) - 1,x 极小时比 exp(x) - 1 精确得多
double exp(double x);      // C / C++ 的 math.h
SELECT EXP(1) FROM dual;   // Oracle / MySQL / PostgreSQL
=EXP(1)                    // Excel / LibreOffice
awk 'BEGIN{print exp(1)}'
$exp(x);                   // Verilog 实数系统函数

要点:

3.1 顺带一提:浮点数的 ''exp'' 是另一个东西

IEEE 754 把一个浮点数拆成三段:符号位 + exp(阶码,exponent) + 尾数(significand)。

单精度 32 位: [1 位符号][8 位 exp][23 位尾数]
双精度 64 位: [1 位符号][11 位 exp][52 位尾数]

数值 = (-1)^符号 × 1.尾数 × 2^(exp - 127)      // 单精度偏置 127,双精度偏置 1023

这里的 exp 是阶码,表示乘的是 2 的多少次幂,和上面的数学函数 exp() 毫无关系。同理,科学计数法里 1.23e5 的 e 指的是十进制指数。

4. exp 还是这些缩写

4.1 export:导出

exp userid=scott/tiger file=scott.dmp owner=scott    # 导出
imp userid=scott/tiger file=scott.dmp full=y         # 导入

4.2 expiry / expiration:有效期

4.3 experience:经验值

游戏与激励系统里的 EXP:EXP +120、升级曲线、exp 字段。含义就是经验值,与令牌过期无关。

4.4 expression:表达式

编译原理与解析器代码里,exp 常是表达式非终结符的缩写:

exp  : exp '+' term
     | term
     ;
term : term '*' factor
     | factor
     ;

在 Bison / ANTLR / 手写递归下降解析器里看到 Exp、Expr、Expression 节点,说的都是「表达式」。

5. 一句话总结

在 JWT 里,''exp'' 就是**过期时刻**:一个用 Unix 秒表示的 NumericDate,验证方必须检查「现在是否已经越过它」,配合 ''nbf''、''iat'' 组成令牌的时间窗口;在数学里,''exp'' 是**以 e 为底的指数函数**。两者只是共用三个字母,判断时看值的长相即可 —— 十位数的整数是时间戳,带小数点的结果是函数值。

相关:payload(有效载荷) · sub · JWT · digest(摘要)


返回:代码术语

# exp

## 先判断语境
- 后面跟 Unix 时间戳 → 令牌过期
- 出现在数值库 → 指数函数
- 出现在命令行或文件名 → 导出

## JWT 的 exp(过期时间)
### 定义
- RFC 7519 注册声明名
- expiration time,过期时刻
- 值是 NumericDate:Unix 秒
- 不是字符串,不是毫秒
- 名字短是为了省令牌体积
- 可选字段,但出现就必须校验
### 时间类 claim
- exp:过期时刻
- nbf:not before 生效时刻
- iat:issued at 签发时刻
- jti:令牌 ID,配合黑名单撤销
### 校验逻辑
- 现在必须早于 exp
- leeway 30–60 秒吸收时钟偏移
- 过期返回 401 + invalid_token
### 代码
- jose:setExpirationTime("15m")
- jsonwebtoken:expiresIn 是相对时长
- PyJWT:leeway 与 require
- ignoreExpiration 绝不能开
### 常见坑
- 毫秒当秒写,令牌永不失效
- 服务端时钟不同步,大量 401
- 只在前端校验,形同虚设
- 以为短 exp 就能撤销
- 业务有效期混进 exp
- 宽松库与严格库行为不一致

## 数学的 exp(指数函数)
### exp(x) = e^x
- e ≈ 2.718281828
- 是 ln 的反函数
- exp(a+b) = exp(a)·exp(b)
### 代码中的 exp
- math.exp / exp() / EXP() / $exp
- exp vs pow:底数是否固定
- 双精度溢出阈值 x ≈ 709.78
- 下溢为 0,C 返回 inf
- 小 x 用 expm1,大精度
- softmax 减最大值防溢出
### 浮点数的 exp
- 指 exponent,阶码
- 符号位 + exp + 尾数
- 与数学 exp() 无关

## 其他缩写义项
### export 导出
- Oracle exp / imp、expdp / impdp
- MSVC 的 .exp 导出文件
- 源码里 exp = exported
### expiry 有效期
- 银行卡 EXP MM/YY
- HTTP Expires 用日期格式
- Cookie 的 Max-Age 优先
### experience 经验值
- 游戏或激励系统里的 exp 字段
### expression 表达式
- 文法里的非终结符 exp
- 解析器里的 Exp / Expr 节点

## 记住这三点
- 令牌里的 exp 是秒级时间戳
- 数学里的 exp 是以 e 为底的指数
- 看到三个字母先看位置和值的长相