Azure Cosmos DB自定义函数返回结果数量与表记录数一致问题排查

问题根源 #

1. SQL查询逻辑导致返回多条结果 #

你的SQL语句 SELECT udf.findUserByPhoneNumber(c,["14168000000","17200000000"]) FROM c 中，FROM c 会遍历容器内的每一个文档，对每个文档执行一次UDF。容器里有4个用户文档，自然会返回4条结果——这是查询遍历逻辑决定的，和UDF本身无关。

2. UDF自身的逻辑错误 #

• 参数不匹配：UDF定义的第一个参数是users（预期为用户数组），但调用时传入的是c（单个用户文档），逻辑完全错位。
• 循环提前返回：return result; 写在for循环内部，第一次循环就会直接返回，后续循环根本无法执行。
• 目标偏离：你需要的是筛选出匹配手机号的用户，但当前UDF仅返回匹配的手机号，没有关联到用户文档的筛选逻辑。

正确解决方案 #

方案1：直接用SQL筛选（无需UDF，推荐） #

如果只是简单匹配手机号，直接用SQL的WHERE子句即可，这是最高效的方式：

SELECT * FROM c 
WHERE ARRAY_CONTAINS(["14168000000","17200000000"], c.userPhoneNumber)

这条语句会遍历容器文档，仅返回userPhoneNumber在指定数组中的记录，符合你“仅返回一条记录”的需求。

方案2：修复UDF并配合查询筛选（若必须用UDF） #

步骤1：修复UDF代码

调整UDF为判断单个用户的手机号是否在目标数组中：

function isPhoneInList(user, contactNumbers){
    for (let i = 0; i < contactNumbers.length; i++) {
        if (user.userPhoneNumber === contactNumbers[i]) {
            return true;
        }
    }
    return false;
}

步骤2：使用UDF筛选的SQL

SELECT * FROM c 
WHERE udf.isPhoneInList(c, ["14168000000","17200000000"])

该查询仅返回UDF返回true的文档，即匹配手机号的用户。

特殊场景：容器内是单文档包含users数组 #

如果你的容器里只有一个文档（结构如你最初粘贴的{"users": [...]}），需要调整查询为遍历数组元素：

SELECT u FROM c JOIN u IN c.users
WHERE ARRAY_CONTAINS(["14168000000","17200000000"], u.userPhoneNumber)

这条语句会展开users数组，筛选出匹配的用户对象。

内容的提问来源于stack exchange，提问作者Sumchans