<p>C# 中无内置 OData 类或命名空间，它是协议与库的组合；ASP.NET Core OData 服务需正确注册 AddOData 和 MapODataRoute（须在 MapControllers 后），控制器名与实体集名严格匹配，启用查询需 [EnableQuery] 及 AddOData 配置，客户端应使用 Microsoft.OData.Client 并确保响应 Content-Type 符合 OData v4 协议。</p>
直接说结论：C# 中没有叫 OData 的内置类或命名空间，它不是语言特性，而是协议 + 服务端/客户端库的组合实现。你写的是 ASP.NET Core OData 服务，还是用 ODataClient 调用别人的服务？搞错这个前提，后面全偏。
ASP.NET Core OData 服务启动失败：MapODataRoute 没生效
常见错误现象是请求返回 404，或者 $metadata 根本访问不到。根本原因不是路由写错了，而是 MapODataRoute 没在正确位置注册。
- 必须在
Program.cs中调用AddOData（服务注册）和MapODataRoute（终结点映射），缺一不可 -
MapODataRoute必须放在app.MapControllers()之后，否则中间件链不识别 OData 路由 - 实体集名（如
"Products"）要和控制器名（ProductsController）严格匹配，大小写敏感 - 若用 EF Core 模型，EDM 模型构建必须显式调用
modelBuilder.EntitySet<T>("Name")，不能只靠约定
OData 查询参数（$filter、$expand）不生效
不是客户端没发，而是服务端没接住。默认情况下，ASP.NET Core OData 不自动启用任何查询选项，必须显式开启。
- 控制器方法上加
[EnableQuery(AllowedQueryOptions = AllowedQueryOptions.All)]，否则$filter、$orderby全被忽略 -
$expand还需额外配置：在AddOData时传入opt => opt.EnableQueryFeatures().SelectExpand().Filter().OrderBy().Count().SkipToken() - EF Core 查询中，
IQueryable返回前不能提前.ToList()或.AsEnumerable()，否则 OData 查询逻辑在内存执行，不走数据库 - 字符串比较默认区分大小写（SQL Server），若需忽略大小写，得在
$filter中显式用tolower()或改数据库排序规则
从 C# 客户端调用 OData 服务：别硬写 HttpClient
手拼 URL + HttpClient 发 GET 请求看似简单，但很快会掉进类型转换、分页、元数据解析的坑里。
- 优先用官方
Microsoft.OData.Client库，它能自动生成强类型上下文，支持 LINQ 查询转成 OData URI - 初始化时必须提供服务根地址和元数据文档（
https://api.example.com/odata/$metadata），否则DataServiceContext构建失败 - 分页处理要主动检查
response.GetContinuation()，不能只靠$top/$skip硬算 - 遇到
DataServiceQueryException，先看 InnerException.Message —— 大部分是服务端未启用某查询选项，而非网络问题
最易被忽略的一点：OData v4 协议要求所有响应必须带 Content-Type: application/json;odata.metadata=minimal（或 full/none），如果服务端返回纯 application/json，.NET 客户端会直接抛 InvalidOperationException，连错误详情都不给。这不是代码 bug，是协议握手失败。
