栅格瓦片服务经常把计算表达式暴露给调用端：它能减少预处理，却也把数据类型、函数参数和语法错误带进请求链路。rio-tiler 9.4.6 的修复没有新增炫目的图层能力，而是收紧一件更影响运维的事：无效表达式应以稳定、可预期的应用层错误返回。
可核查事实
- rio-tiler 9.4.6 于 2026-09-16 发布。
- 该 Release 的唯一变更说明为“修复/捕获所有无效表达式”。
- 关联 PR 为 #1001，标题为“Fix/catch all invalid expression”。
- PR #1001 于 2026-09-16 创建并在同日合并。
apply_expression仍会重新抛出MemoryError。- 除
MemoryError外，apply_expression捕获其他Exception并转换为InvalidExpression。 - 新参数化测试覆盖浮点数组位运算、错误函数参数、字符串操作数、非有限常量和标量结果等非法表达式。
核心机制
rio-tiler 9.4.6于2026-09-16发布。该Release的唯一变更说明为“修复/捕获所有无效表达式”。关联PR为#1001，标题为“Fix/catch all invalid expression”。这说明版本目标很集中：把底层计算库可能给出的多类异常收敛为调用端能处理的表达式错误。
除MemoryError外，apply_expression捕获其他Exception并转换为InvalidExpression。MemoryError仍会重新抛出。这里的边界有实际意义：前者属于用户输入或计算语义问题，适合反馈为请求失败；后者依赖进程与机器资源，不能伪装成“表达式写错了”。
GIS 场景
在 COG 或多资产影像服务中，前端可能提交波段组合、指数、阈值或掩膜表达式。过去如果同类错误在不同数据类型下冒出不同的底层异常，网关、监控和客户端都会难以形成统一的重试或提示策略。统一为 InvalidExpression 后，调用方可以将其标为可修正的 4xx 类输入问题，而不是把所有失败视为服务故障。
新参数化测试覆盖浮点数组位运算、错误函数参数、字符串操作数、非有限常量和标量结果等非法表达式。它们正是遥感分析页面常出现的边界：用户把整数位运算用于浮点波段、函数参数数量不对，或表达式无法产生预期栅格数组。
技术路径
- 为表达式入口定义允许的波段名、函数、操作符和返回形状。
- 在 API 层把
InvalidExpression映射为统一错误码和可读提示，不回传底层堆栈。 - 保留请求 ID、表达式摘要和数据集版本，方便定位但避免日志泄露敏感内容。
- 单独监测
MemoryError与超时，把它们纳入容量和限流处置。 - 用合法表达式、语法错误、类型错误和超大请求组成回归集。
检查清单
- 非法表达式是否稳定返回同一种应用层错误？
- 客户端能否区分输入错误、资源不足和服务超时？
- 错误响应是否包含可修正信息而不暴露内部实现？
- 相同表达式在不同数据类型和资产组合下是否行为一致？
- 日志、限流和告警是否避免把输入错误误报为平台故障？
风险边界
统一异常类型不会判断一条表达式在科学意义上是否合理，也不能解决极大范围、过高分辨率带来的内存压力。服务仍需给表达式、空间范围、波段数与并发设置独立上限，并对结果精度和掩膜语义做业务验证。
资料依据
本文依据 rio-tiler 9.4.6 官方 Release 与 PR #1001 撰写。版本、代码处理与测试范围来自一手仓库；接口建议为工程解读。
结论
对表达式驱动的瓦片服务，稳定地拒绝错误输入和正确计算同样重要。将可修正输入错误与资源异常分开，才能让调用端、监控和容量治理各自做对的事。