Pact Broker 升级后，消费者配置中的 pactFileWriteMode=overwrite 失效的问题。通过分析问题原因，即 Pact 客户端库已移除该配置，并提供启用 allow_dangerous_contract_modification 功能的替代方案，帮助开发者理解并解决 Pact 文件覆盖问题。同时，强调了启用该功能可能带来的风险，建议采用更安全的版本控制方式。
在 Pact Broker 升级到 2.107.1 版本后，一些开发者可能会遇到 pactFileWriteMode=overwrite 配置失效的问题，导致无法覆盖已存在的相同版本号的 Pact 文件。 这篇文章将深入探讨这个问题的原因，并提供相应的解决方案。
问题根源：Pact 客户端库的变更
问题的根本原因在于 Pact 客户端库（例如 pact-js）在 10.x.x 版本中移除了 pactFileWriteMode 配置。 该配置原本用于控制本地 Pact 文件的写入模式，允许覆盖同版本文件。 移除该配置是为了鼓励更严格的版本控制，以提高 Pact 测试的可靠性。 详细信息可以参考 Pact 客户端库的迁移文档，例如 pact-js MIGRATION.md。
解决方案：启用 allow_dangerous_contract_modification
虽然 pactFileWriteMode 已被移除，但 Pact Broker 提供了一个配置选项 allow_dangerous_contract_modification，可以实现类似的文件覆盖功能。
启用方法
要启用 allow_dangerous_contract_modification，需要在 Pact Broker 的配置中进行设置。 具体方法取决于 Pact Broker 的部署方式，例如，可以通过环境变量或配置文件进行设置。
示例 (环境变量):
PACT_BROKER_ALLOW_DANGEROUS_CONTRACT_MODIFICATION=true
示例 (Docker Compose):
version: "3.9"
services:
pact-broker:
image: pactfoundation/pact-broker
environment:
PACT_BROKER_ALLOW_DANGEROUS_CONTRACT_MODIFICATION: "true"
ports:
- "9292:9292"配置详解
allow_dangerous_contract_modification 配置项控制是否允许修改已存在的消费者版本的 Pact 内容。 官方强烈建议将其设置为 false，因为允许修改会降低 can-i-deploy 命令的可靠性。 当设置为 false 时，每次提交都必须使用唯一的版本号发布 Pact。 如果尝试修改已存在的合约，Pact Broker 将返回 HTTP 409 状态码。
更详细的配置信息可以参考 Pact Broker 官方文档。
风险提示与最佳实践
尽管 allow_dangerous_contract_modification 提供了文件覆盖的功能，但强烈建议不要启用此选项。 启用此选项可能会导致以下问题：
- can-i-deploy 命令结果不可靠: 如果允许修改已存在的 Pact 文件，can-i-deploy 命令可能无法准确判断服务是否可以安全部署。
- 数据一致性问题: 修改已存在的 Pact 文件可能会导致消费者和提供者之间的合约不一致。
最佳实践:
- 使用唯一的版本号发布 Pact: 每次提交都应该使用唯一的版本号发布 Pact 文件，例如，可以使用 Git 的 commit SHA 作为版本号。
- 避免修改已存在的 Pact 文件: 如果需要修改 Pact 文件，应该创建一个新的版本，而不是覆盖已存在的版本。
- 使用 Pact Broker 的版本控制功能: Pact Broker 提供了强大的版本控制功能，可以帮助管理 Pact 文件的不同版本。
总结
pactFileWriteMode 配置的移除是 Pact 客户端库为了提高 Pact 测试可靠性而做出的改变。 虽然可以使用 allow_dangerous_contract_modification 配置实现文件覆盖，但强烈建议遵循最佳实践，使用唯一的版本号发布 Pact 文件，并避免修改已存在的 Pact 文件，以确保 Pact 测试的准确性和可靠性。 升级到新的 Pact Broker 版本时，务必注意这些配置变更，并根据实际情况进行调整。
