mongodb 不支持 odata 的完整查询能力，因驱动仅有限支持 linq 表达式树，遇 contains、嵌套属性等即抛 notsupportedexception；需绕过 asqueryable()，手动解析 odataqueryoptions 并转为 mongofilter。
直接用 ODataController + EnableQueryAttribute 就能暴露带 $filter、$orderby、$expand 等能力的端点，但关键不在“能不能加”，而在“加了之后数据层是否真能响应”——尤其对接 MongoDB 这类非 SQL 存储时，OData 默认的 LINQ 表达式树翻译会失败。
为什么 Entity Framework 能直接用 OData，MongoDB 不行？
OData 的 [EnableQuery] 依赖后端 IQueryable 提供表达式树解析能力。EF Core 把 $filter=Name eq 'Pizza' 翻译成 SQL WHERE；而 MongoDB.Driver 的 IMongoCollection<t>.AsQueryable()</t> 只支持极有限的 LINQ 操作（比如 .Where(x => x.Name == "Pizza")），遇到 $filter=contains(Name, 'zza') 或嵌套属性 $filter=Address/ZipCode eq '10001' 就抛 NotSupportedException。
常见错误现象：
System.NotSupportedException: The method 'Contains' is not supportedSystem.ArgumentException: Unsupported expression node type: MemberAccess- 返回空结果，但日志里没报错（实际是静默跳过不支持的子句）
绕过 IQueryable，改用 MongoExpression + 自定义 QueryOption 解析
核心思路：不走 AsQueryable()，而是把 OData 查询参数（ODataQueryOptions<t></t>）手动转成 Builders<t>.Filter</t> 支持的表达式。
实操建议：
- 控制器继承
ODataController，但 Action 方法参数去掉[EnableQuery]，改用ODataQueryOptions<restaurant></restaurant>显式接收 - 调用
queryOptions.ApplyTo(collection.AsQueryable(), new ODataQuerySettings())前先拦截并重写 Filter 表达式（需引用Microsoft.AspNet.OData和MongoDB.Driver） - 对
queryOptions.Filter调用.FilterClause.Expression获取原始表达式树，逐节点匹配：BinaryExpression对应eq/ne，MethodCallExpression对应contains/startswith，再映射到Builders<restaurant>.Filter.Regex</restaurant>或.Eq - 特别注意
Address/ZipCode这种路径：MongoDB 驱动要求写成"Address.ZipCode"字符串，不能靠反射自动展开
别忽略 $expand 在 MongoDB 中的实际代价
OData 的 $expand=Grades 看似方便，但在 MongoDB 里没有 JOIN，必须手动做两次查询或用 $lookup 聚合管道——而 ODataController 默认根本不处理 $expand，它只管序列化。
使用场景判断：
- 如果
Grades总是内嵌在Restaurant文档里（即 denormalized），$expand实际无意义，直接返回即可 - 如果
Grades存在独立集合，必须自己实现聚合逻辑：collection.Aggregate().Lookup(...).As<restaurantwithgrades>()</restaurantwithgrades> - 性能影响：一个
$expand可能让单次请求触发 N+1 查询，且无法被[EnableQuery]自动优化
最易被忽略的一点：OData 元数据文档（$metadata）默认由 ODataConventionModelBuilder 生成，但它不会读取 BsonElement 特性。如果你的模型字段名和 MongoDB 字段名不一致（比如 C# 属性叫 ZipCode，数据库存的是 zipcode），元数据里仍显示 ZipCode，导致客户端生成的 $filter 路径错位——必须手动在 ModelBuilder 中用 EntityTypeConfiguration 显式映射字段别名。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
