はじめに
開発環境では .env ファイルを利用して環境変数を管理することが一般的ですが、本番環境（特に AWS ECS などのクラウド環境）では .env ファイルがなくても動作するように設計する必要があります。
今回、ECS にデプロイした Go アプリケーションで 「.env ファイルが読み込めません」 というエラーが発生しました。その原因と対処法について解説します。
起きていたエラー
ECS 上で Go アプリケーションをデプロイした際に、以下のエラーが発生しました。
2025/02/19 02:11:07 .envファイルが読み込めません: open .env: no such file or directory
このエラーは、Go アプリケーションが .env ファイルを読み込もうとして、ファイルが見つからずにクラッシュしていることを示しています。
エラーの原因
1. .env の読み込み処理が GO_ENV=prod でも実行されていた
Go のコード内で .env を読み込む処理が含まれていました。
if os.Getenv("GO_ENV") == "dev" {
err := godotenv.Load()
if err != nil {
log.Fatal(err)
}
}
このコードは GO_ENV=dev のときのみ .env を読み込むはずですが、実際には GO_ENV が正しく設定されていないか、空の状態だったため .env を読み込もうとしてエラーになりました。
2. GO_ENV の環境変数が正しく設定されていなかった
ECS のタスク定義では以下のように GO_ENV=prod を設定していましたが、実際のコンテナ内では設定されていなかった可能性があります。
ECSのタスク定義（Terraform）
"environment": [
{
"name": "GO_ENV",
"value": "prod"
}
]
しかし、ECS のデプロイ後にコンテナ内で GO_ENV を確認すると、設定されていない（"" になっている）ことがありました。
コンテナに入って確認
aws ecs execute-command --cluster my-ecs-cluster --task タスクID --container my-app-repo --command "/bin/sh" --interactive
コンテナ内で実行
echo $GO_ENV
GO_ENV が空のままだった場合、 .env の読み込み処理が実行され、エラーが発生することになります。
3. .env に依存せずに環境変数を利用するべきだった
ECS では環境変数を .env ではなく、ECS のタスク定義 (environment) に直接設定するのが一般的です。そのため、Go のコードで .env を読み込む必要はありませんでした。
解決策
1. .env の読み込み処理を削除する
最も簡単な対策は、.env の読み込みを削除し、環境変数のみに依存するようにすることです。
修正前
if os.Getenv("GO_ENV") == "dev" {
err := godotenv.Load()
if err != nil {
log.Fatal(err)
}
}
修正後
// `.env` を読み込む処理を削除
func NewDB() {
url := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True",
os.Getenv("MYSQL_USER"),
os.Getenv("MYSQL_PW"),
os.Getenv("MYSQL_HOST"),
os.Getenv("MYSQL_PORT"),
os.Getenv("MYSQL_DB"))
var err error
DB, err = gorm.Open(mysql.Open(url), &gorm.Config{})
if err != nil {
log.Fatal(err)
}
fmt.Println("Connected")
}
この変更により、 ECS でも .env ファイルが不要になり、エラーが解消されます。
2. GO_ENV=prod が正しく設定されているか確認
ECS で環境変数が正しく適用されているか確認するには、次のコマンドを実行します。
aws ecs describe-tasks --cluster my-ecs-cluster --tasks $(aws ecs list-tasks --cluster my-ecs-cluster --query 'taskArns[0]' --output text) --query 'tasks[0].containers[0].environment'
ここに GO_ENV=prod が含まれているかチェックしてください。
もし GO_ENV がない場合は、Terraform でタスク定義を適用し直します。
terraform apply -auto-approve
aws ecs update-service --cluster my-ecs-cluster --service my-ecs-service --force-new-deployment
3. ECS の環境変数設定を見直す
ECS のタスク定義に GO_ENV=prod を明示的に追加します。
Terraform の ECS タスク定義
"environment": [
{
"name": "GO_ENV",
"value": "prod"
},
{
"name": "MYSQL_USER",
"value": "myuser"
},
{
"name": "MYSQL_PW",
"value": "${jsondecode(data.aws_secretsmanager_secret_version.rds_password_v5.secret_string)[\"password\"]}"
},
{
"name": "MYSQL_HOST",
"value": "${aws_db_instance.rds_instance.endpoint}"
}
]
Terraform を適用後、ECS のタスクを強制再デプロイすることで、環境変数が適用されます。
aws ecs update-service --cluster my-ecs-cluster --service my-ecs-service --force-new-deployment
まとめ
エラーの原因
-
.envの読み込み処理が実行されていた -
GO_ENV=prodが適用されていなかった -
.envに依存するコードになっていた
解決策
-
.envの読み込み処理を削除 -
GO_ENV=prodを ECS のタスク定義に明示的に設定 - Terraform を適用後、ECS タスクを再デプロイ
この対応を行うことで、 ECS 環境で .env に依存せずに動作するようになり、エラーが解消できました。