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