下表详细介绍了各种问题和错误状态代码，以及可能的原因和可采取的措施来缓解部署问题。如需查看汇总服务的完整错误规范和缓解措施，请参阅我们当前的公开指南。
指南主题：
权限和授权错误
| 问题 | 在对公开云项目执行 terraform plan 或 terraform apply 时出现权限问题。 |
|---|---|
| 错误示例 | Error: UnauthorizedOperation: You are not authorized to perform this operation. |
| 分辨率 |
检查您是否已正确对您所用公共云的 CLI（命令行界面）进行身份验证。 Amazon Web ServicesAWS 要求用户具备相应权限，才能创建汇总服务所需的实例和其他服务。应用此设置后，您应该能够顺利执行 Terraform 方案并进行应用。 Google Cloud Platform请注意，在 Google Cloud 中，您必须模拟服务账号才能部署 Terraform 的后半部分。如果您跳过了此步骤，您的 terraform apply 命令可能会失败，因为部署服务账号具有创建资源的所有必要权限。请参阅 GitHub 文档中的“设置部署环境”部分中的第 4 步。 |
隐私预算错误
| 错误 | PRIVACY_BUDGET_ERROR |
|---|---|
| 原因 | 这表示该服务因隐私预算服务出错而无法处理报告。 |
| 检查 | 重试作业以查看错误是否是间歇性错误后，请通过技术支持表单与我们联系。 |
| 错误 | PRIVACY_BUDGET_AUTHORIZATION_ERROR |
|---|---|
| 原因 | 您使用的报告来源可能与他们在初始配置期间提供的来源不同。 |
| 检查 |
请确保您在 该网站应与已添加的网站匹配，或者属于其子网域。请注意，汇总服务的初始配置是在顶级网域中进行的，顶级网域完成初始配置后，所有子网域都符合使用汇总服务的条件。 |
| 错误 | PRIVACY_BUDGET_AUTHENTICATION_ERROR |
|---|---|
| 原因 | 您使用的 ARN 可能已过时或不正确。 |
| 检查 |
Google Cloud Platform
检查汇总服务部署中使用的服务账号是否与初始配置期间提供的服务账号一致。必须完全匹配，而不仅仅属于同一项目。 Amazon Web Services您应该使用通过电子邮件提供给您的协调员。如果您仍遇到问题，请收集 auto.tfvars 文件和报告来源信息，然后通过技术支持表单与我们联系。 |
| 错误 | PRIVACY_BUDGET_EXHAUSTED |
|---|---|
| 原因 |
错误：
"result_info": {
"return_code": "PRIVACY_BUDGET_EXHAUSTED",
"return_message": "com.google.aggregate.adtech.worker.exceptions.AggregationJobProcessException:
Insufficient privacy budget for one or more aggregatable reports. No aggregatable report can appear
in more than one aggregation job. Information related to reports that do not have budget can be
found in the following file:
File path: 如果您尝试批量处理的报告的共享 ID 已包含在之前成功的批处理中，就会出现隐私预算耗尽问题。出现此错误是因为“无重复”规则：可汇总的报告只能出现在单个批次中，并且只能纳入到一份摘要报告中。 每个报告都会分配一个“共享 ID”，该 ID 由 |
| 检查 |
我们建议您尝试使用作业响应中提供的“隐私预算已用尽”支持来检查和解决错误。这提供了一个新的辅助 JSON 文件，可让您了解哪些报告导致了错误。 请注意，如果您正确设置了批量处理，则可能有资格恢复预算（此处有详细说明）。建议他们阅读说明并填写表单，但请注意，他们的请求需要获得批准，才能成功恢复预算并重新运行作业。 |
| 错误 | DEBUG_SUCCESS_WITH_PRIVACY_BUDGET_EXHAUSTED |
|---|---|
| 原因 |
这表示您是在调试模式下运行作业。createJob 请求中的 job_parameters 包含 debug_run: true。启用 debug_run 标志后，您可以多次运行报告以进行调试。此错误消息旨在告知您，如果作业未在调试模式下运行，则会因报告的隐私预算耗尽而失败。此错误仅适用于 v2.10.0 或更低版本。
|
| 检查 |
createJob 请求正文中的 job_parameters 将包含 debug_run。
{
"job_request_id": "{job_request_id}",
"input_data_blob_prefix": "{input_prefix}",
"input_data_bucket_name": "{input_bucket}",
"output_data_blob_prefix": "{output_prefix}",
"output_data_bucket_name": "{output_bucket}",
"job_parameters": {
"output_domain_blob_prefix": "{output_domain_prefix}",
"output_domain_bucket_name": "{output_domain_bucket}",
"attribution_report_to": "{reporting_origin}",
"debug_run": "true"
}
}
|
作业运行时错误
| 错误 | INVALID_JOB |
|---|---|
| 端点 | createJob |
| 原因 | 如果提供的调试隐私 epsilon 不在 [0.64] 范围内，或者作业参数未通过验证，就可能会发生这种情况。 |
| 检查 |
使用了什么 epsilon 值？createJob 请求中使用了哪些作业参数？这些参数是否与您的环境匹配？格式是否正确？进行必要的更正，然后重试作业。
|
| 错误 | INTERNAL_ERROR |
|---|---|
| 端点 | getJob |
| 原因 | 可能是格式问题，导致输出网域或报告的处理失败。也可能是 Aggregation Service 部署存在问题。 |
| 检查 | 确保输出网域位置是有效的路径。重试作业。如果错误仍然存在，请请求 auto.tfvars 文件和 Terraform 计划输出，以便排查其汇总服务部署问题。
|
| 错误 | RESULT_WRITE_ERROR |
|---|---|
| 端点 | getJob |
| 原因 | 如果向输出目录写入失败（暂时性失败或由于目录缺少写入权限），就可能会发生这种情况。请注意，写入错误确实会消耗隐私预算，并且作业无法重试。这可能会导致另一个 PRIVACY_BUDGET_EXHAUSTED 错误结果。 |
| 检查 | 此错误是发生在每项作业中，还是仅间歇性发生？如果每个作业都出现此问题，请确保您已为输出目录启用写入权限。如果这是间歇性失败，则权限应该是正确的。写入摘要报告可能会失败，但隐私预算仍会消耗，这是一个已知问题。在这种情况下，您可以申请恢复预算（说明）。 |
| 问题 | 在运行作业和检索认证服务令牌时遇到 403 错误，并且作业始终返回状态“已收到”。 |
|---|---|
| 错误 |
{
"job_status": "RECEIVED",
"request_received_at": "{utc timestamp}",
"request_updated_at": "{utc timestamp}",
"job_request_id": "0001",
"input_data_blob_prefix": "reports/",
"input_data_bucket_name": "{bucket_name}",
"output_data_blob_prefix": "summary/",
"output_data_bucket_name": "{bucket_name}",
"postback_url": "",
"job_parameters": {
"output_domain_bucket_name": "{bucket_name}",
"output_domain_blob_prefix": "output_domain/",
"attribution_report_to": |
| 分辨率 |
如果服务账号尚未完成初始配置，作业通常会卡在 验证注册和新手入门状态后，请检查正在运行的作业发生了什么情况。 Amazon Web Services发生这种情况时，AWS 孤岛可能未运行或已崩溃，因此无法接收作业。
托管式实例组 (MIG) 的运行状况可能不佳。如果这是首次进行设置，或者您销毁并重新创建了
|
您的摘要报告是否按预期转换？
在某些情况下，您的 getJob 调用可能会成功，但 Aggregation Service 返回的摘要报告存在问题。摘要报告采用 AVRO 格式，需要转换为 JSON 格式。转换为 JSON 格式后，其内容将类似如下所示。
{
"bucket": "\u0005Y",
"metric": 26308
}
如果 AVRO 转换出现任何问题，请尝试使用 AVRO 工具，并对 AVRO 报告使用以下命令。java -jar avro-tools-1.11.1.jar tojson [report_name].avro > [report_name].json
您可以点击此处下载稳定版。如果您需要进一步的帮助，请继续执行后续步骤。
后续步骤
在 Privacy Sandbox 状态信息中心或公开 GitHub 代码库中，检查是否有人遇到了同样的问题。