研报有了但一致预期为空：让股票研究任务交付可核实的部分
研报接口返回了有效报告，但一致预期数组为空时，应该分别判断两个数据块。继续完成能够由单份报告支持的计算，把市场一致预期字段保留为空，并明确阻断依赖它们的结论。空数组既不代表预期盈利为零，也不能证明这家公司没有分析师覆盖。
本例用虚构的A股研究响应执行一段Python处理程序：保留两条可核实的券商估值记录，同时停止三项依赖一致预期的输出。这是教学用的适配后数据处理，不是实时供应商测试，也不表示CoTrading已经提供自动降级功能。未来工作台需要进一步核实接口契约、持久化和运行监测，才能向用户提供相应能力。
先判断响应内容，再解释公司经营
传输成功与研究数据完整是两件事。外层成功标记可能只说明一个研报来源返回了内容，第二个一致预期来源仍然可能报错或没有返回观察值。做公司摘要以前，应逐块检查数据形状、来源与可用范围，不要将一个部分成功响应概括成“所有盈利预期都不可得”。
本地检查到的研究工具面向A股研报，并单独尝试查询一致预期。研报查询有时间窗口和数量上限，一致预期则属于尽力获取的数据块。因此，代码结构允许研报成功而一致预期为空。但阅读静态代码不能证明某次线上空返回的原因，更不能证明供应商中断或这只股票的真实覆盖人数。
在供应商与计算层之间设置明确的标准化响应。本例要求外层包含成功标记和数据对象，内部包含报告列表与一致预期块。每份报告必须有报告编号、券商、财年、币种、盈利口径和来源标识。这是教程自己定义的输入契约，原始工具响应仍然需要经过单独验证的适配器，不能直接假设字段可以互换。
区分四种容易被混在一起的状态
任何计算开始以前，先按下面的规则登记一致预期块：
| 输入情况 | 本例状态 | 可以支持的解释 |
|---|---|---|
| 字段缺失或空值 | 缺少数据块 | 没有提供可用的数据块 |
| 空列表 | 空且原因待核实 | 这次返回没有观察值 |
| 本应是列表却返回对象 | 数据形状不合法 | 不符合本例输入契约 |
| 非空列表 | 仍须另验供应商上下文 | 尚未核实覆盖与计算定义 |
最后一行刻意没有直接接受市场一致预期。存在一个数值，不等于已经确认贡献券商范围、聚合方法、目标财年和修订时间。本程序验证的是缺失分支，没有实现完整的正常一致预期分支。要扩展正常分支，应先写清供应商定义，再增加相应输入、反例与验收条件。
Python的JSON官方文档说明了对象、数组与空值如何映射到语言中的结构。这些规则能够帮助检查响应形状，却不能解释金融含义。空值被解析为程序空值以后，其业务原因仍然需要来自研究记录，不能仅凭一个空数组判断接口故障。
保留能够独立成立的券商估值行
冻结一组完全合成的数据：股价为人民币20元，目标财年为2027年。券商B1的摊薄每股盈利预测为人民币1.2元，券商B2为1.4元。两条来源标识都是测试样本，不代表真实报告、投资建议或未来业绩承诺。
| 报告 | 券商 | 每股盈利 | 可支持的前瞻市盈率 |
|---|---|---|---|
| r1 | B1 | 1.2 | 20除以1.2，约16.6667倍 |
| r2 | B2 | 1.4 | 20除以1.4，约14.2857倍 |
这是同一冻结价格下的两种券商预测情景，不是市场一致预期的两次观察。每行保留财年与来源，内部使用完整精度，展示时才四舍五入。脚本采用十进制计算，断言核对实际除法结果，而不是只比较经过截断的展示字符串。
本例假设适配器已经确认证券身份和每股单位。接入真实报告时，还必须检查币种、基本或摊薄盈利、发布时间，以及这些预测在研究截止时点是否已经可得。即便两个数字都能成功解析，将公司总利润与每股价格相除，所得倍数仍然没有合理的估值含义。
报告数量也不能自动转化为覆盖人数。两份报告可能来自同一机构不同日期，也可能只是返回上限截取的样本。应保留报告级身份，先解决重复与时点问题，再讨论样本统计。此次程序只计算已明确输入的两行，不声称已经执行完整覆盖整理。
阻断依赖，而不是用替代数字填满表格
程序将市场一致预期每股盈利和一致预期市盈率保留为空；被阻挡的任务还包括“相对一致预期的盈利超预期幅度”。三项都需要空数据块无法提供的证据。有效研报行仍保持“已完成券商单独计算”的状态，使用户能够看清还有哪些结果可用。
不要把1.2与1.4平均成1.3，再称为市场一致预期。有限返回可能漏掉其他券商，包含重复机构，或者混合不同日期的预测。即使算术平均没有错，它也只描述这个特定样本。脚本明确记录没有使用报告均值替代，并断言两项市场级字段始终为空。
展示顺序可以是部分成功状态、可核实报告表、三项被阻挡依赖，最后附上一致预期来源核实任务。不要用整体绿色完成标记暗示全部请求都已经执行；同时也不必因为独立来源缺失而丢弃已经验证的报告计算。部分成功的价值来自边界清晰，而不是字段看起来齐全。
在保存结果时，最好让状态与数值同时存在。只有空数值却没有原因，后续程序可能把它填为零；只有状态却没有来源，读者又无法重做计算。输入、结果、状态和被阻挡依赖应共同组成这次有限交付，而不是散落在无法关联的日志中。
实际运行主例和失败分支
下载完整可执行程序，保存为对应文件后运行：
python -I -B R560.py程序只使用Python标准库与内存中的合成输入，不需要接口凭证，不调用模型，也不下载历史预测。输出包含主例、异常数值、外层失败和空报告四组结果。退出码为零只代表这些固定样本的断言通过，不代表外部服务可用，更不能认证真实报告的财务可靠性。
主例同时核对两条券商市盈率与一致预期空值。第二组将一条盈利改为非有限数，另一条改为零，并给一致预期块传入错误形状。两条报告的市盈率都保持为空，但拒绝原因不同。外层失败时返回工具失败，并阻断全部计算；报告列表为空时则返回没有可用报告行，不把空表当成完整公司评估。
注意两种拒绝不能互相替代。非有限值不能参加正常除法；零或负每股盈利在本流程中不生成通常意义上的正市盈率。程序保留这些不同状态，不将坏数据悄悄改成零，也不通过捕获异常后填默认值来制造一份看似完成的结果。
Decimal有限性检查可以识别已经解析成功但仍然是非数或无穷的值。解析成功只是计算入口的第一步，不能替代有效性验证。真正接入供应商时，也应保留原始输入快照，便于追查问题是发生在上游、适配器还是计算层。
规定恢复后的版本与验收规则
缺失来源后来恢复时，应建立带新获取时间和新证据的研究版本。先核实一致预期定义，再解除三项计算的阻断；保留此前部分成功的记录，让用户区分当时已知的信息与后来补到的信息。后来的预测不能悄悄进入历史判断，造成看似早已掌握新数据的错觉。
供应商异常与报告行验证失败也要分开处理。本例要求报告的必要身份字段已经标准化，不是任意响应都能交给它解析。生产扩展应在适配层明确拒绝身份损坏的行，增加覆盖数量、去重与拒绝记录，并为所承诺的输入结构建立对应反例，而不是无限扩大一个教学函数的职责。
发布前逐行确认：展示数字能追溯到可用报告；市场级缺失字段仍为空；被阻挡任务紧邻结果可见；冻结价格与目标财年已经写明。这样的交付既能继续利用有效证据，也让尚未完成的研究有明确补齐路径，而不会把数据缺口隐藏进一段流畅摘要中。
常见问题
一致预期为空，能否判断这只股票没有分析师覆盖？
不能。它只表示这次响应没有提供一致预期观察值。覆盖情况、权限和供应商故障都需要另外核实。
能否用返回研报的平均值替代一致预期？
另行核实后可以将样本统计明确标为样本统计，但本程序没有计算它。不能把样本均值当作市场一致预期，也不能据此解除依赖一致预期的计算阻断。