⛳

運用中サービスのGoのアップグレード作業の詳細解説

に公開

この記事はREALITY Advent Calendar 2025の12/19の記事として書きました。
他の記事もよろしければどうぞ!

https://qiita.com/advent-calendar/2025/reality_inc

はじめに

こんにちは。REALITYのサーバエンジニアのseiji ochiaiです。

REALITYのサーバアプリでは主にGoを使って実装しています。
今回はGoのバージョンをGo 1.22からGo 1.24にアップグレードした際の作業記録と知見をまとめてみました。
最新バージョンであるGo 1.25について記載しようかと迷いましたが、Go 1.25はGo 1.24ほど破壊的変更点がなく、主に既存機能の互換性を保った改善と、新機能の追加が多かったので、作業として色々あったGo 1.24へのアップグレードの作業内容を元に解説します。基本的には観点としては同じようなところを見ていますので問題ないかと思います。
できるだけ具体的な作業内容を記述していきます。

想定読者

Goの基本的な仕様を理解していて、これからGoのバージョンアップを検討している方向けの記事です。

Goの後方互換性について

Go 1の互換性方針

さて、Goは後方互換性を重視している言語ですが、セキュリティ上の理由による破壊的変更や、ライブラリの仕様変更など、バージョンアップ時には注意すべき点が複数存在します。

Goは後方互換性を大事にしている言語としてよく知られていますが、これはそもそもどこから来ている話なのでしょうか?
ちょっと気になったので(もしかしたら単なる都市伝説かもしれない..)調べてみたのですが、この方針は公式ドキュメント「Go 1 and the Future of Go Programs」で定義されています。
以下引用です。

it is intended that programs written to the Go 1 specification will continue to compile and run correctly, unchanged, over the lifetime of that specification. At some indefinite point, a Go 2 specification may arise, but until that time, Go programs that work today should continue to work even as future "point" releases of Go 1 arise (Go 1.1, Go 1.2, etc.).

↓日本語訳(google gemini)

Go 1仕様に基づいて記述されたプログラムは、その仕様の存続期間中、変更されることなく正しくコンパイルおよび実行され続けることが意図されています。ある時点でGo 2仕様が登場する可能性もありますが、それまでは、現在動作するGoプログラムは、Go 1の将来の「ポイント」リリース(Go 1.1、Go 1.2など)が登場しても引き続き動作するはずです。

これは公式サイトのドキュメントなので、確かに信頼はおけそうです。

互換性の例外

ただし、以下のケースにおいては互換性を損なう変更が行われることも続けて書かれています。

  1. セキュリティ: 仕様または実装において、解決のために互換性を損なう必要のあるセキュリティ問題が明らかになる場合。
  2. 仕様上の誤り: 仕様上の不一致または不完全性に対処する必要が生じた場合、その解決は既存のプログラムの意味または合法性に影響を与える可能性があります。ただし、セキュリティ上の問題を除き、仕様に互換性のない変更は行わないとしています。
  3. バグ: コンパイラまたはライブラリに仕様に違反するバグがある場合、そのバグを修正すると、そのバグのある動作に依存するプログラムが動作しなくなる可能性があります。
  4. unsafeパッケージ: unsafeパッケージをインポートするプログラムは、Go実装の内部プロパティに依存する場合があり、実装の変更によって動作に支障をきたす可能性があります。

実務上の注意点

上記の方針から、バグや仕様上の誤りは当然ながら、それ以外だと特にセキュリティ関係については注意深く見る必要があることがわかります。今まで動作していたコードでも、セキュリティ上の理由で変更が加えられる可能性があるためです。暗号化関連のライブラリやTLS/SSL周りの実装などもその一つです。
このあたりに気をつけつつアップグレード作業の準備をする必要があります。

過去に踏んだ失敗事例

Go 1.22での暗号スイート削除問題

さてここで1つ失敗談を話します。
Go 1.21からGo 1.22へのアップグレード時に、RSA鍵交換ベースの暗号スイートがデフォルトのリストから削除されたことにより、とある外部サービスAPIとの疎通ができなくなるという問題が発生しました。これはまさに、先に書かれている「セキュリティ関係の仕様変更」です。

問題の詳細

Go 1.22では、以下の暗号スイートがデフォルトから削除されました。

0x0035: "TLS_RSA_WITH_AES_256_CBC_SHA"
0x003C: "TLS_RSA_WITH_AES_128_CBC_SHA256"
0x009C: "TLS_RSA_WITH_AES_128_GCM_SHA256"
0x009D: "TLS_RSA_WITH_AES_256_GCM_SHA384"

該当の社外サービスAPIは、これらのRSA鍵交換ベースの暗号スイートでなければ疎通できない仕様だったため、TLS handshakeに失敗し、疎通ができなくなりました。確認が不足していた...といえばそれまでですが「Goは後方互換性を大事にしているから暗号スイートが削除されるとかはないだろう」という甘い思い込みがありました。よくないですね。

対応方法

外部APIの仕様はこちらでは変更できないため、GODEBUGの設定で古い挙動に戻すことで対応しました。

ENV GODEBUG="tlsrsakex=1"

この設定により、削除された暗号スイートを再度有効化し、疎通ができるようになりました。

実際の作業

では実際の作業の内容について解説していきます。

リリースノートの精査

調査対象

Go 1.22からGo 1.24へのアップグレードにあたり、以下のリリースノートを精査しました:

調査方法

リリースノートの精査は以下のように進めました。

  • リリースノート全体をAIで日本語訳し、破壊的変更や注意すべき点を抽出。
  • 気になる点や修正が必要な点にコメント。
    逐一翻訳したリリースノートにコメントをつけていく
  • AIにも破壊的変更について抽出してもらい、対応作業として漏れがないか確認

リリースノート全文を細かく確認していくのはそれなりに手間なのでAIによるダブルチェックは作業軽減に役にたちました。

Go 1.23の変更点

Go 1.23の変更点のうち、コード変更が発生しそうな箇所を主にみていきました。

  1. time.TimerおよびTime.Tickerの動作変更

    • タイマーチャネルがバッファなし(容量0)に変更。lenやcapが0を返すようになり、ResetやStopのセマンティクスが変更。
    • GODEBUG設定で古い挙動に戻すことが可能です。
  2. net/httpのヘッダー削除

    • ServeContent、ServeFile、ServeFileFSがエラー時に特定のヘッダーを削除
    • Content-Encoding: gzipなどのオンザフライエンコーディングを適用するミドルウェアに影響の可能性
    • エラー時の動作のため、影響範囲は限定的なのと、調査の結果、影響がないことを確認しました。
  3. net/netipのreflect.DeepEqual修正

    • Addr値の比較におけるバグが修正
    • 特定のreflect.DeepEqual比較の結果が変わる可能性
    • 調査の結果、deepequalの使用箇所はほとんどがテストコードで、netipに対しては使用していないことを確認しました。
  4. crypto/tlsの3DES暗号スイート削除

    • 3DESがデフォルトリストから削除
    • これについては詳しくは後述しますが、外部の全疎通先を確認し問題ありませんでした。

Go 1.24の変更点

同じようにGo 1.24の変更点もいくつかみていきます。

  1. ジェネリック型エイリアス

    • デフォルトで有効化
    • Go 1.25でGOEXPERIMENT=noaliastypeparams設定が削除予定
  2. Vetツールの変更

    • printfアナライザがfmt.Printf(s)形式の呼び出しに対して診断を報告

    • 非定数の書式文字列で、他の引数がない場合に警告

    • 以前はlintでwarnが出る程度だったため回避の余地がありましたが、go vetで報告されるようになり回避不可能になりました。全ての箇所に//go:build go1.23を入れるよりも、コードを修正したほうが効率的と判断し、以下のように修正しました:

      // 警告が出る例
      package main
      
      import "fmt"
      
      func main() {
          v := "hello"
          fmt.Printf(v)  // non-constant format string in call to fmt.Printf
      }
      

      修正例:

      // 修正後
      package main
      
      import "fmt"
      
      func main() {
          v := "hello"
          fmt.Print(v)  // もしくは fmt.Printf("%s", v)
      }
      
  3. math/rand.Seedの変更

    • 非推奨のトップレベルSeed関数が効果なし(no-op)になりました。

    • GODEBUG設定 randseednop=0 で古い動作に戻すことが可能。

    • Go 1.20以降、グローバル疑似乱数ジェネレータは自動的にランダム値でシード済み。

    • 既存コードを確認したところ、乱数生成時にnano secの数値を渡しており、意図的に乱数のシードを固定値にしているような処理はありませんでした。したがって基本的に問題ないと判断しました。実際の使用箇所はGitHub上で確認でき、単純にrand.Seedを削除するだけで対応可能でした。

    • 一応内部実装も確認すると、以下のように変化しています。

      • Go 1.19以前
        func Intn(n int) int { return globalRand.Intn(n) }
        
        var globalRand = New(&lockedSource{src: NewSource(1).(*rngSource)})
        
      • Go 1.24
        func Intn(n int) int { return globalRand().Intn(n) }
        
        func globalRand() *Rand {
            if r := globalRandGenerator.Load(); r != nil {
                return r
            }
        
            // 初回呼び出し時にGODEBUGに基づいて初期化
            var r *Rand
            if randautoseed.Value() == "0" {  // autoseed無効(1.19以前の挙動)
                randautoseed.IncNonDefault()
                r = New(new(lockedSource))
                r.Seed(1)  // 固定seedを渡している
            } else {
                r = &Rand{
                    src: &runtimeSource{},
                    s64: &runtimeSource{},
                }
            }
            // ...
        }
        
    • 実際の修正としては、既存コードから不要なrand.Seed()呼び出しを削除しました。

      // 修正前
      rand.Seed(now.UnixNano())
      digit := rand.Intn(999)
      
      // 修正後(Seed呼び出しを削除)
      digit := rand.Intn(999)
      
  4. crypto/randの変更

    • Read関数が失敗しなくなった
    • エラーが発生するとプログラムがクラッシュするように変更
    • 使用箇所はありますが、エラーが発生しなくなっただけなので特に影響はありませんでした。
  5. crypto/rsaの破壊的変更(重要)

    • 1024ビット未満の鍵でGenerateKey、Sign、Verify、Encrypt、Decryptがエラーを返す

    • セキュリティ上の理由だが、古いキーを使用している場合は影響大

      • GODEBUG設定 rsa1024min=0 で以前の動作に戻すことが可能
    • ParsePKCS1PrivateKeyとParsePKCS8PrivateKeyがより厳密な検証を実施

      • GODEBUG設定 x509rsacrt=0 で以前の動作に戻すことが可能
    • Go 1.24から1024ビット未満のRSA鍵が要求された場合、エラーを返すようになりました。これは非常に破壊的な変更で、rsaを使っていてこれらの関数を使っている場合、エラーになるため使用箇所を確認しました。

    • APIリクエスト時に社内ライブラリのkeyで検証している箇所がありますが、すぐに変更するのは難しいので暫定対応として、DockerfileにGODEBUGを設定し、1024ビット未満の鍵を使用できるようにしました:

      ENV GODEBUG="rsa1024min=0"
      
  6. crypto/x509の変更

    • x509sha1 GODEBUG設定が削除
    • Certificate.VerifyがSHA-1ベースの署名をサポート終了
    • 調査の結果、Certificate.Verifyは使っていませんでした。rsa.VerifyPKCS1v15()でSHA1を使っていますが、これは証明書の検証ではなくハッシュアルゴリズムのVerifyなので、crypto/x509のSHA-1署名サポート終了の影響は受けません。
    • ただし、SHA-1はいろんなところで廃止になりつつあり、SHA-1ベースのものを使っているのはあまり良くないことは認識しています。今回のGoアップグレードとは別にkeyの仕様を変更する必要がありそうだったので、改善チケットを別に起票して今回はGODEBUGで回避しています。

Goの仕様変更以外のコードの変更点

Goの仕様変更のコード変更以外に当然バージョンアップに伴い、versionが記載された箇所の修正があります。
主に以下のような作業です。

バージョン変更作業

  1. .go-versionの更新

    • プロジェクトルートの.go-versionファイルを変更
  2. go.modの更新

    • リポジトリ内の全go.modファイルのgoバージョンを変更
    module reality/servers/go/common
    
    go 1.24.3
    
  3. Dockerfileの更新

    • リポジトリ内でGoに依存している全Dockerfileのイメージバージョンを変更
    FROM golang:1.24.3-alpine3.21 AS builder
    
  4. 依存関係の精査

    • go.modを変更した全ディレクトリでgo mod tidyを実行
    • Goバージョンが上がることでパッケージバージョンが変わることもあります。
    • Goは最小バージョン選択(Minimal Version Selection)を採用しているため、大幅な変更は少ないですが、重要なpackageの更新には注意が必要です。
  5. samber/loのバージョン管理

    • Go 1.24ではgenericsがtype aliasで使えるようになったため、samber/loの実装が変わりました。v1.50.0(最新版)に上げると以下のようなエラーが発生:
    hoge.go:73:9:
    cannot use lo.Chunk[Amount](list, AtOnce) (value of type []Amounts) as [][]Amount value in return statement
    
    • 原因はv1.43.0からv1.44.0での以下の変更でした。
    // v1.43.0
    - func Uniq[T comparable](collection []T) []T {
    
    // v1.44.0以降
    + func Uniq[T comparable, Slice ~[]T](collection Slice) Slice {
    
    • 全ての使用箇所を変更するのは手間なため、今回はloのバージョンを戻して対応しました。後日、loのバージョンアップは行います。
  6. Linterの対応

    • Goのバージョンアップに伴い、golangci-lintの対応Goバージョンに合わせるために、golangci-lintのバージョンアップも行いました。この際に、golangci-lintの定義ファイルのバージョンもv1からv2へマイグレーションしました。
    • マイグレーションの詳細は多岐に渡るためここには書きませんが、公式のMigration guideと、AIのサポートが大変役に立ちました。

暗号スイートの互換性確認

過去の失敗事例の教訓から、暗号スイートの変更を重点的に確認しました。

バージョンごとの対応の違い

暗号スイートの対応はGoのライブラリのsrc/crypto/tls/cipher_suites.goに記載されています。
それぞれ少し抜粋してみましょう。

  • https://github.com/golang/go/blob/go1.21.1/src/crypto/tls/cipher_suites.go#L53
    func CipherSuites() []*CipherSuite {
    	return []*CipherSuite{
    		{TLS_RSA_WITH_AES_128_CBC_SHA, "TLS_RSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_RSA_WITH_AES_256_CBC_SHA, "TLS_RSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_RSA_WITH_AES_128_GCM_SHA256, "TLS_RSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_RSA_WITH_AES_256_GCM_SHA384, "TLS_RSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    
    		{TLS_AES_128_GCM_SHA256, "TLS_AES_128_GCM_SHA256", supportedOnlyTLS13, false},
    		{TLS_AES_256_GCM_SHA384, "TLS_AES_256_GCM_SHA384", supportedOnlyTLS13, false},
    		{TLS_CHACHA20_POLY1305_SHA256, "TLS_CHACHA20_POLY1305_SHA256", supportedOnlyTLS13, false},
    
    		{TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256, "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256", supportedOnlyTLS12, false},
    	}
    }
    
  • https://github.com/golang/go/blob/go1.22.12/src/crypto/tls/cipher_suites.go#L53
    func CipherSuites() []*CipherSuite {
    	return []*CipherSuite{
    		{TLS_AES_128_GCM_SHA256, "TLS_AES_128_GCM_SHA256", supportedOnlyTLS13, false},
    		{TLS_AES_256_GCM_SHA384, "TLS_AES_256_GCM_SHA384", supportedOnlyTLS13, false},
    		{TLS_CHACHA20_POLY1305_SHA256, "TLS_CHACHA20_POLY1305_SHA256", supportedOnlyTLS13, false},
    
    		{TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256, "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256", supportedOnlyTLS12, false},
    	}
    }
    
  • https://github.com/golang/go/blob/go1.24.3/src/crypto/tls/cipher_suites.go#L56
    func CipherSuites() []*CipherSuite {
    	return []*CipherSuite{
    		{TLS_AES_128_GCM_SHA256, "TLS_AES_128_GCM_SHA256", supportedOnlyTLS13, false},
    		{TLS_AES_256_GCM_SHA384, "TLS_AES_256_GCM_SHA384", supportedOnlyTLS13, false},
    		{TLS_CHACHA20_POLY1305_SHA256, "TLS_CHACHA20_POLY1305_SHA256", supportedOnlyTLS13, false},
    
    		{TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA, "TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA, "TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA, "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA, "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA", supportedUpToTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256, "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384, "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", supportedOnlyTLS12, false},
    		{TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256, "TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256", supportedOnlyTLS12, false},
    		{TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256, "TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256", supportedOnlyTLS12, false},
    	}
    }
    

それぞれ微妙に違いがあるのがわかります。ただこれを毎回目視でチェックするのも大変ですし漏れが出ます。また、細かいことを言うと、これはあくまで全対応のリストであり、GODEBUGの設定が必要なものはまた違ってきます。

とはいえ、必要な暗号スイートが網羅されているかを毎回確認するのは面倒なため、以下のように必要な暗号スイートを列挙して、テストコードで確認できるようにしています。これならGoバージョンアップなどで暗号スイートがサポートされなくなった時にCIからのエラーで確認できます。

func TestCipherOutput(t *testing.T) {
	// defaultとinsecureを分けているのは、insecureの場合はGODEBUG設定が必要となるため、defaultからinsecureになった場合も検出したいため
	expectedDefaultCipherSuites := map[uint16]string{
		0xC013: "TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA",
		0xC014: "TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA",
		0xC02B: "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256",
		0xC02C: "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384",
		0xC02F: "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
		0xC030: "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384",
	}

	// 非セキュアな暗号スイートのマップ
	//MEMO: Defaultでは使用できない。GODEBUG="tlsrsakex=1"を設定することで、RSAの暗号スイートを使用できるようになる。
	expectedInsecureCipherSuites := map[uint16]string{
		0x003C: "TLS_RSA_WITH_AES_128_CBC_SHA256",
		0x009C: "TLS_RSA_WITH_AES_128_GCM_SHA256",
		0x009D: "TLS_RSA_WITH_AES_256_GCM_SHA384",
	}

	// CipherOutput関数を実行
	defaultCipherSuites, insecureCipherSuites := CipherOutput()

	defaultCipherSuiteMap := lo.SliceToMap(defaultCipherSuites, func(suite *tls.CipherSuite) (uint16, string) {
		return suite.ID, suite.Name
	})
	insecureCipherSuiteMap := lo.SliceToMap(insecureCipherSuites, func(suite *tls.CipherSuite) (uint16, string) {
		return suite.ID, suite.Name
	})

	for id, name := range expectedDefaultCipherSuites {
		if _, ok := defaultCipherSuiteMap[id]; !ok {
			t.Errorf("暗号スイート %s (0x%04X) がDefaultでサポートされていません", name, id)
		}
	}

	for id, name := range expectedInsecureCipherSuites {
		if _, ok := insecureCipherSuiteMap[id]; !ok {
			t.Errorf("暗号スイート %s (0x%04X) がInsecureでサポートされていません", name, id)
		}
	}

	// 基本的な動作確認
	if len(defaultCipherSuites) == 0 {
		t.Error("デフォルト暗号スイートが取得できませんでした")
	}
	if len(insecureCipherSuites) == 0 {
		t.Error("非セキュア暗号スイートが取得できませんでした")
	}
}

外部API疎通確認

今回のバージョンでは暗号スイートの変更があったこともあり、外部APIとの疎通は全て確認しました。
具体的な外部APIは記載できませんが、それぞれ以下のように対応している方式を確認し、それぞれ疎通できるかをテスト環境から確認しています。
公開されているサイトやAPIであれば、webツールを使って暗号方式などを確認可能です。以下はssllabのwebツールを使って確認した場合の表示です。
(ここは地道な作業なので割と時間がかかりました...)

外部APIの対応方式を逐一調査していく図

開発環境でのアプリ機能の動作確認

当然、実アプリでの操作し、主要機能の動作確認も行います。
ここではアプリ機能の詳細は書きませんが、アプリの挙動を見ながら、サーバログの確認作業も詳細に進めます。

まとめ

Goは後方互換性を大事にしているとはいえ色々気にするべきところはやはり多かったです。

  1. Goの後方互換性は高いが、セキュリティ関連は例外

    • セキュリティ上の理由による変更は破壊的変更となり得る。
    • 特に暗号化関連(crypto/*)、TLS/SSL関連は要注意。
  2. リリースノートの精査

    • 全文を日本語訳して読み込む。
    • AIを活用してダブルチェックを行う。
    • 破壊的変更を洗い出す。
  3. 外部APIとの統合点は重点確認項目

    • 暗号スイートの互換性。
    • TLSバージョンの対応状況。
  4. GODEBUGによる回避策の活用

    • 破壊的変更の多くはGODEBUGで古い挙動に戻せる。
    • ただし、セキュリティリスクとのトレードオフを考慮する必要がある。
    • 長期的には新しい実装に移行すべき(とはいえ、外部APIや外部のpackageなどの仕様上変更が難しいことも...)
  5. 地道な確認

    • リリースノート精査 → コード調査 → 別環境での動作確認 → 本番反映
    • 地道な疎通確認は手間ですが重要。

本作業を通じて、Goのバージョンアップにおけるアプローチと、セキュリティ関連変更への対応方法を確立できました。
これらの知見は、今後のバージョンアップにも活用できるものと考えています。

REALITY Tech

Discussion