写单元测试（覆盖边界）

为一个函数生成高覆盖率测试，重点照顾边界、异常与空值。

请为下面的函数编写单元测试：
- 使用 [填写测试框架，如 Vitest/Jest/pytest]；
- 覆盖正常路径、边界值（空、零、极大/极小、null）、异常输入；
- 每个用例写清「测什么、为什么」，用例名可读；
- 需要 mock 的外部依赖请显式标出。

函数：
"""
[在此粘贴]
"""