代码术语:exp

exp

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

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

语境 含义 典型长相
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 时间戳 → 令牌过期;出现在数值库或数学表达式里 → 指数函数;出现在命令行或文件名里 → 导出。**

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

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

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 之前」,否则该令牌必须判为无效
claim 全称 含义 校验方向
exp expiration time 过期时刻 当前时间必须早于它
nbf not before 生效时刻 当前时间必须晚于 / 等于它
iat issued at 签发时刻 判断令牌年龄,配合 maxAge 使用
jti JWT ID 令牌唯一标识 配合黑名单实现撤销
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=“invalidtoken”, errordescription=“The access token expired”
// 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"]})
# 只解码中间那段 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 只能用于排查问题,不能当安全保证。

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

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)),就是为了躲开这个溢出区间
  • 概率计算尽量在对数域做加法代替原值相乘,避免中间结果溢出

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 指的是十进制指数。

  • 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];具体以定义处为准。
  • 银行卡:卡面上的 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 的,基本都指到期时间

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

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

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

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

在 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 为底的指数
- 看到三个字母先看位置和值的长相

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/exp.txt
  • 最后更改: 2026/10/13 17:37
  • 由 张叶安