エラーの概要

Terraform の 409 エラーは、Terraform が作成・更新しようとするリソースが既にクラウド環境に存在し、状態ファイル（tfstate）に記録された期待値と実際のリソース状態に競合が生じていることを示します。このエラーは特にマルチユーザー環境や手動でリソースを作成した後に Terraform で管理を開始する場合に発生しやすくなります。

実際のエラーメッセージ例

Error: Error creating XXX: XXX (xxx): InvalidParameterException: Resource already exists
  on main.tf line 42, in resource "aws_instance" "web":
   42: resource "aws_instance" "web" {

 Error: ConflictException

{
  "error": "conflict",
  "message": "The resource with name 'my-bucket' already exists",
  "status_code": 409
}

よくある原因と解決手順

原因 1：手動で作成したリソースを Terraform で管理しようとしている

クラウド管理コンソールやコマンドラインで直接作成したリソースに対して、Terraform コードで同じリソースを定義すると、Terraform はそのリソースが「新規作成される対象」だと判断します。しかし実際にはリソースが存在するため、作成時に 409 エラーで競合が検出されます。

この場合、terraform import コマンドを使い、既存のリソースを Terraform の管理下に移す必要があります。

Before（エラーが起きるコード）：

resource "aws_s3_bucket" "data_bucket" {
  bucket = "my-existing-bucket"
}

AWS マネジメントコンソールで my-existing-bucket が既に存在している場合、terraform apply 実行時に 409 エラーが発生します。

After（修正後）：

# ステップ 1: Terraform コードで空のリソースブロックを定義
# main.tf
resource "aws_s3_bucket" "data_bucket" {
  bucket = "my-existing-bucket"
}

# ステップ 2: 既存リソースを tfstate に取り込む
terraform import aws_s3_bucket.data_bucket my-existing-bucket

# ステップ 3: terraform plan で差異を確認し、必要に応じて .tf ファイルを修正
terraform plan

ACL（アクセス制御リスト）を設定する場合は、Terraform AWS Provider のバージョン 4.0 以降では aws_s3_bucket_acl リソースを使用することが推奨されています。

resource "aws_s3_bucket" "data_bucket" {
  bucket = "my-existing-bucket"
}

resource "aws_s3_bucket_acl" "data_bucket_acl" {
  bucket = aws_s3_bucket.data_bucket.id
  acl    = "private"
}

原因 2：terraform apply が中断して中途半端な状態になっている

terraform apply の実行中にネットワークが切れたり、プロセスが強制終了されたりすると、リソースの一部が作成されたまま tfstate が更新されないことがあります。その状態で再度 terraform apply を実行すると、既に存在するリソースとの競合が発生します。

この場合、terraform refresh でクラウドの実態をもとに tfstate を最新の状態に更新し、差異を解消します。

Before（エラーが起きる状況）：

# 最初の apply 実行中に中断
$ terraform apply

# ... (実行中にネットワーク切断)

# 再度 apply を実行するとエラー
$ terraform apply
Error: ConflictException: Resource already exists

After（修正後）：

# ステップ 1: tfstate をクラウドの実態に同期
terraform refresh

# ステップ 2: 差異を確認
terraform plan

# ステップ 3: 再度 apply を実行
terraform apply

原因 3：tfstate ファイルが古く、実際のインフラストラクチャーと差異がある

複数のユーザーが同じクラウド環境を管理している場合、あるユーザーが手動でリソースを削除したり、別のツール（CloudFormation など）でリソースを作成したりすると、tfstate の記録内容と実際のクラウドリソースの状態がずれます。その状態で terraform apply を実行すると、削除されたはずのリソースを再作成しようとして競合が発生することがあります。

Before（エラーが起きるコード）：

# terraform コード
resource "aws_instance" "app_server" {
  ami           = "ami-0c55b159cbfafe1f0"
  instance_type = "t2.micro"
  tags = {
    Name = "app-server"
  }
}

# 注意: 誰かが AWS コンソールでこのインスタンスを削除したが、
# tfstate にはまだリソースが記録されている

After（修正後）：

# ステップ 1: tfstate をクラウドの現在の状態に同期
terraform refresh

# ステップ 2: plan で差異を確認
terraform plan

# ステップ 3: plan の出力を確認してから apply
terraform apply

# 別案: 既存のリソースが Terraform の定義と合致しない場合
# terraform state rm で tfstate から削除してから再度管理下に入れる
terraform state rm aws_instance.app_server
terraform import aws_instance.app_server i-1234567890abcdef0

Terraform 固有の注意点

リモートバックエンドの競合： Terraform をチームで使用する場合、tfstate を S3 や Terraform Cloud などのリモートバックエンドで管理します。複数のメンバーが同時に apply を実行すると、状態ファイルのロック機構が働き、409 エラーと似た競合エラーが発生する可能性があります。この場合は、terraform force-unlock で不要なロックを解除してください。

# ロックの状態を確認（Terraform Cloud の場合）
terraform console

# 不要なロックを強制解除
terraform force-unlock <LOCK_ID>

プロバイダーの設定誤りも関連： 複数の AWS アカウントやリージョンで同じリソース名を使用する場合、プロバイダーの設定誤りが 409 エラーを引き起こすことがあります。provider ブロックが正しく指定されているか確認してください。

# 正しい設定例
provider "aws" {
  alias  = "prod"
  region = "us-east-1"
}

resource "aws_s3_bucket" "prod_bucket" {
  provider = aws.prod
  bucket   = "my-prod-bucket"
}

それでも解決しない場合

1. tfstate の詳細を確認：

# tfstate の内容を確認（該当リソースが記録されているか）
terraform state show <resource_type>.<resource_name>

# 全リソースを一覧表示
terraform state list

2. デバッグログを出力：

# ログレベルを DEBUG に設定して詳細を確認
TF_LOG=DEBUG terraform apply 2>&1 | tee terraform_debug.log

3. クラウドプロバイダーのログを確認： AWS の場合は CloudTrail、Google Cloud の場合は Cloud Audit Logs を確認し、リソース作成の試行がどの段階で失敗したかを追跡します。

4. 公式ドキュメントの参照：

5. 最終手段：tfstate の手動修正（非推奨）： 上記の手段でも解決しない場合、tfstate を直接編集することも可能ですが、データ損失のリスクがあるため、バックアップを取得してから実行してください。

# tfstate のバックアップを作成
cp terraform.tfstate terraform.tfstate.backup

# tfstate をテキストエディターで編集（JSON 形式）
vim terraform.tfstate

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。