【現象】
macOS 環境で zig build または zig fetch を使ってリモート依存を取得する際、以下のようなエラーが発生することがあります。
error: invalid HTTP response: HttpConnectionClosing
この問題は、リモートリポジトリから依存を取得できず、ビルド処理が中断される形で現れます。
【原因】
現時点では、これは Zig 自体のロジック不具合というより、システムのプロキシ環境変数に起因するものと考えられます。
HTTP/HTTPS プロキシ(ターミナル上の設定やシステムレベルのプロキシを含む)が推奨・設定されている場合、状況によって Zig の接続が異常になり、上記エラーを引き起こすことがあります。
関連の議論として、Zig コミュニティの issue(プロキシ経由でリモートリポジトリにアクセスできない件)を参照してください。
【暫定的な回避策】
現時点で正式な修正はなく、プロキシ環境変数をクリアすることで回避できます。
unset http_proxy https_proxy all_proxy HTTP_PROXY HTTPS_PROXY ALL_PROXY
実行後にビルドコマンドを再実行すると、多くの場合は正常に動作します。
【結論】
・本質:プロキシ環境変数により Zig のネットワークリクエストが異常になる
・影響範囲:macOS 環境で比較的発生しやすい
・対処:一時的にプロキシ関連の環境変数を解除する
・状態:コミュニティ既知の問題で、今後の公式改善待ち
【補足】
開発環境で常時プロキシが必要な場合は、次を検討してください。
・Zig でビルドする時だけ一時的にプロキシを無効化する
・もしくは、環境変数を自動で切り替えるスクリプトを用意する
開発がうまく進みますように