差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

后一修订版
前一修订版
代码术语:exp [2026/10/13 17:35] – 创建 张叶安代码术语:exp [2026/10/13 17:37] (当前版本) – 为 exp 页面添加结构总览思维导图 张叶安
行 1: 行 1:
-1+====== exp ====== 
 + 
 +先说结论:''exp'' 是一个**高度依赖语境**的缩写。代码里最常见的两个意思是 —— **令牌里的「过期时间」claim(expiration time)**,和 **数学里的指数函数 e<sup>x</sup>**。此外它还能表示 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]]): 
 + 
 +<code json> 
 +{ 
 +  "sub": "1234567890", 
 +  "iat": 1700000000, 
 +  "exp": 1700003600        // ← 这串数字就是过期时间 
 +} 
 +</code> 
 + 
 +==== 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 校验时真正发生的事 ==== 
 + 
 +<code> 
 +if (now - leeway >= exp)   reject("token expired") 
 +if (nbf && now + leeway < nbf)   reject("token not active") 
 +</code> 
 + 
 +  * ''leeway''(也叫 clock tolerance)通常取 **30–60 秒**,用来吸收多台服务器之间的时钟偏移 
 +  * 精度是**秒**:当 ''now == exp'' 时各库边界处理略有差异,别把业务卡在过期那一秒 
 +  * 校验失败一般返回 **401**,按 RFC 6750 应带 ''WWW-Authenticate: Bearer error="invalid_token", error_description="The access token expired"'' 
 + 
 +==== 2.4 生成与校验的代码 ==== 
 + 
 +<code javascript> 
 +// 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" 
 +} 
 +</code> 
 + 
 +<code javascript> 
 +// 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 校验,生产环境绝不要开 
 +</code> 
 + 
 +<code python> 
 +# 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"]}) 
 +</code> 
 + 
 +==== 2.5 手工看一眼 ''exp'' ==== 
 + 
 +<code bash> 
 +# 只解码中间那段 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" 
 +</code> 
 + 
 +注意:这只是**解码,不是验证**。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) = e<sup>x</sup>'',其中 e 是自然常数 ≈ 2.718281828459045。它是自然对数 ''ln'' 的反函数: 
 + 
 +<code> 
 +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) 
 +</code> 
 + 
 +各语言里基本都叫 ''exp'': 
 + 
 +<code python> 
 +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 精确得多 
 +</code> 
 + 
 +<code> 
 +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 实数系统函数 
 +</code> 
 + 
 +要点: 
 + 
 +  * **''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)**。 
 + 
 +<code> 
 +单精度 32 位: [1 位符号][8 位 exp][23 位尾数] 
 +双精度 64 位: [1 位符号][11 位 exp][52 位尾数] 
 + 
 +数值 = (-1)^符号 × 1.尾数 × 2^(exp - 127)      // 单精度偏置 127,双精度偏置 1023 
 +</code> 
 + 
 +这里的 ''exp'' 是**阶码**,表示乘的是 2 的多少次幂,和上面的数学函数 ''exp()'' 毫无关系。同理,科学计数法里 ''1.23e5'' 的 ''e'' 指的是十进制指数。 
 + 
 +===== 4. exp 还是这些缩写 ===== 
 + 
 +==== 4.1 export:导出 ==== 
 + 
 +  * **Oracle 的 ''exp'' / ''imp''**:经典的数据导出导入工具;10g 之后官方主推数据泵 ''expdp'' / ''impdp'',但老脚本里 ''exp'' 仍然随处可见 
 + 
 +<code bash> 
 +exp userid=scott/tiger file=scott.dmp owner=scott    # 导出 
 +imp userid=scott/tiger file=scott.dmp full=y         # 导入 
 +</code> 
 + 
 +  * **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'' 常是**表达式非终结符**的缩写: 
 + 
 +<code> 
 +exp  : exp '+' term 
 +     | term 
 +     ; 
 +term : term '*' factor 
 +     | factor 
 +     ; 
 +</code> 
 + 
 +在 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 为底的指数 
 +- 看到三个字母先看位置和值的长相 
 +``` 

该主题尚不存在

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

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