====== 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|payload]]):
{
"sub": "1234567890",
"iat": 1700000000,
"exp": 1700003600 // ← 这串数字就是过期时间
}
==== 2.1 规范怎么定义 ====
''exp'' 是 RFC 7519 定义的 **Registered Claim(注册声明名)**,全称 **expiration time**:
* 值必须是 **NumericDate**:**从 1970-01-01T00:00:00Z 起算的秒数**,允许带小数
* **不是字符串,不是毫秒,更不是日期字符串** —— ''"2026-01-01T00:00:00Z"'' 这种写法不合规范
* 名字只有三个字母是刻意设计:claim 名越短令牌越小,''sub''、''iss''、''aud''、''exp''、''iat''、''nbf''、''jti'' 都是这个思路
* 它本身**可选**,但**一旦出现就必须被校验** —— 规范要求「当前时间必须在 ''exp'' 之前」,否则该令牌必须判为无效
==== 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")
* ''leeway''(也叫 clock tolerance)通常取 **30–60 秒**,用来吸收多台服务器之间的时钟偏移
* 精度是**秒**:当 ''now == exp'' 时各库边界处理略有差异,别把业务卡在过期那一秒
* 校验失败一般返回 **401**,按 RFC 6750 应带 ''WWW-Authenticate: Bearer error="invalid_token", error_description="The access token expired"''
==== 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|payload]] 与 [[代码术语:hex|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 实数系统函数
要点:
* **''exp'' 与 ''pow'' 的分工**:''exp(x)'' 底数固定为 e;''pow(a,b)'' 是任意底数,很多实现内部反过来借 ''exp(b·ln a)'' 计算
* **溢出阈值**:双精度最大约 1.8e308,对应 ''x ≈ 709.78'',超过就溢出(C 返回 ''inf'',Python 抛异常,NumPy 给 ''inf'' 加警告)
* **精度**:x 很小时 ''exp(x) - 1'' 会因抵消误差丢有效位,用 ''expm1'';反向的 ''ln(1+x)'' 用 ''log1p''
* **机器学习里 softmax 要减去最大值**(算 ''exp(x - max)''),就是为了躲开这个溢出区间
* 概率计算尽量在**对数域**做加法代替原值相乘,避免中间结果溢出
==== 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:导出 ====
* **Oracle 的 ''exp'' / ''imp''**:经典的数据导出导入工具;10g 之后官方主推数据泵 ''expdp'' / ''impdp'',但老脚本里 ''exp'' 仍然随处可见
exp userid=scott/tiger file=scott.dmp owner=scott # 导出
imp userid=scott/tiger file=scott.dmp full=y # 导入
* **Windows / MSVC 的 ''.exp'' 文件**:链接器生成 DLL 时会一并产出 ''foo.dll''、''foo.lib''(导入库)和 ''foo.exp''(导出文件),''.exp'' 里记录该 DLL 对外导出的符号。三件套同时出现是正常现象。
* **源码里的 ''exp'' 变量**:很多项目里它就是 ''export'' / ''exported'' 的缩写,例如 ''exp := exports[name]'';具体以定义处为准。
==== 4.2 expiry / expiration:有效期 ====
* **银行卡**:卡面上的 ''EXP'' 或 ''VALID THRU'' 是卡片有效期(''MM/YY''),常和 CVV 一起被要求提供
* **HTTP 缓存 / Cookie**:''Expires'' 响应头用的是 **HTTP 日期格式**(''Expires: Wed, 21 Oct 2015 07:28:00 GMT''),和 JWT 用秒数完全不同;Cookie 的 ''Max-Age'' 优先级高于 ''Expires''
* **证书 / 域名 / 许可证**:报表里缩写成 ''exp''、''expiry'' 的,基本都指到期时间
==== 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|payload(有效载荷)]] · [[代码术语:sub|sub]] · [[jwt|JWT]] · [[代码术语:digest|digest(摘要)]]
----
返回:[[代码术语]]
```mdk height=560 color=#4f46e5
# 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 为底的指数
- 看到三个字母先看位置和值的长相
```