--- title: 'CodeQL 2.27.1で何が変わる？ CIの検出差分を見誤らない実務ガイド' url: 'https://automationse.net/codeql-2-27-1-ci-alert-review-guide' markdown: 'https://automationse.net/codeql-2-27-1-ci-alert-review-guide.md' date: '2026-09-26' description: ' DEVELOPMENT / CODE SCANNING / 2026.09.25 ## アラートの増減は、コードの変化とは限らない CodeQL 2.27.1は、対応言語・データフローモデル・クエリの精度を更新しました。CIの結果を読むときは、解析器の更新と実際のコード変更を分けて確認することが重要です。 **C/C++**新しい比較式クエリとライブラリのデータフローモデル **Kotlin 2.4.20**K2コンパイラの抽出修正で誤検知を低減 **CI運用**新規・解消アラートをバージョン差分と照合 ## 3行要約 - GitHubは2026年9月25日、静的解析エンジン「CodeQL 2.27.1」の更新内容を発表しました。 - C/C++の新クエリ、Kotlin 2.4.20対応に加え、FastifyやGitHub Actionsなどで解析精度が変わります。 - アラート数の増減だけで安全性を判断せず、使用バージョンとクエリIDを記録して差分をレビューするのが実務的です。 ## 背景：CodeQLは何をしている？ CodeQLはソースコードを解析してデータベース化し、クエリで問題のあるパターンを探す静的解析エンジンです。GitHubのcode scanningで利用され、プルリクエストや定期実行の結果をアラートとして表示できます。コードを書き換えずに検査しますが、解析器のモデルやクエリ自体が改善されると、同じコードでも結果が変わり得ます。今回の更新は「脆弱性が一斉に新規発生した」という意味ではありません。GitHubの発表にある機能変更を、開発・運用チームがどのように受け止めるかが焦点です。 ## 何が新しいのか | 対象 | GitHubが発表した変更 | 現場で見るべき差分 | |---|---|---| | C/C++ | `cpp/ambiguous-assignment-of-comparison`を追加。Boost.Asioの名前解決などのデータフローモデルも拡充 | 新しいクエリIDでの検出と、入力が危険な処理へ流れる経路 | | Java/Kotlin | Kotlin 2.4.20に対応。K2の`Foo::class.java`抽出を修正 | Androidの`java/android/implicit-pendingintents`等の誤検知減少 | | JavaScript/TypeScript | Fastifyの`withTypeProvider()`等を介したルート定義を認識 | レート制限クエリの新規結果、プラグイン保護による誤検知減少 | | GitHub Actions | 有効な`actions.lock`で固定されたActionや同一リポジトリ参照を適切に扱う | `actions/unpinned-tag`の解消理由 | | Go / Rust / C# | Go 1.27 API、Rustの`core::fmt::Write`、C#のグローバルCSRFフィルター等の扱いを改善 | 対象言語・フレームワークの結果変化 | 「データフロー」は値が入力元から処理先までどう伝わるかを追跡する解析です。モデルが追加されると、以前はつながらなかった経路を検出できる可能性があります。一方、フレームワークの保護機構を正しく認識すると、誤検知が減る可能性があります。いずれも個別アラートの内容確認が必要です。 ## 開発者・企業への影響 GitHubによれば、github.com上のcode scanning利用者には各CodeQLバージョンが自動展開されます。GitHub Enterprise Serverは3.24に今回の機能が含まれる予定で、古いGHESでは手動アップグレードという選択肢があります。自前のCLIや解析パイプラインを固定している場合は、実際に使ったCodeQLバージョンを別途確認してください。編集上の推論として、複数言語を持つリポジトリでは、今回の更新だけでアラートの件数・位置・重複が変化し得ます。件数の棒グラフだけを品質KPIにせず、クエリIDと検出箇所、解析バージョンを併記するのが妥当です。 ## 導入・運用で試す4ステップ **1 対象を確認**利用中のCodeQLバージョン、言語、クエリスイートを記録 **2 再実行**同じコミットで解析し、コード変更の影響を分離 **3 差分を分類**新規・解消・場所変更をクエリID単位で確認 **4 判断を残す**真陽性、誤検知、保留の理由をアラートに記録具体例として、Fastifyのルートを持つリポジトリで`js/missing-rate-limiting`が新たに出た場合、まず実際のルートとレート制限プラグインの適用範囲を照合します。新規検出だけで「更新が脆弱性を作った」と結論づけるのは誤りです。逆にアラートが消えた場合も、保護設定を確認せずに安全と断定しないでください。高度なセットアップを使う場合、GitHub Docsはプッシュ・プルリクエスト・定期実行のトリガーや分析対象言語をワークフローで設定できると説明しています。まず現行のワークフローと実行ログを確認し、比較対象の実行条件をそろえましょう。 ## リスクと限界 **注意：**静的解析はすべての脆弱性を発見する保証ではありません。検出件数の減少が修正を証明するわけでも、増加が新たな欠陥を証明するわけでもありません。 - クエリスイート、ビルド条件、依存関係、実行トリガーが違えば、バージョン以外の理由でも結果は変わります。 - FastifyやKotlin K2などの改善は、該当するコードを使うリポジトリで初めて影響します。 - C/C++の新クエリを含む各変更の重大度は一律ではありません。アラートごとの影響範囲と到達可能性を評価してください。 - GitHubの自動展開の説明を、固定バージョンの独自CIにそのまま当てはめないでください。 ## 今後注目すべき点 GHES 3.24での提供時期、既存リポジトリにおけるクエリ別の検出差分、Rustの解析器更新に伴うカスタムクエリへの影響を確認したいところです。とくにカスタムクエリを管理するチームは、公式の詳細変更履歴も併読してください。 **最終確認日：2026年9月26日** ### 参照元（一次情報） - [GitHub Changelog：CodeQL 2.27.1の発表（2026年9月25日）](https://github.blog/changelog/2026-09-25-codeql-2-27-1-adds-c-and-c-query-and-kotlin-2-4-20-support/) - [GitHub Docs：CodeQL code scanningの概要](https://docs.github.com/en/code-security/concepts/code-scanning/codeql/codeql-code-scanning) - [GitHub Docs：code scanningのワークフロー設定](https://docs.github.com/en/code-security/reference/code-scanning/workflow-configuration-options) Previous Post Next Post --- ## Navigation - Previous: [盗まれたセッションだけで設定変更させない｜GitHubのProof of Presenceを解説](https://automationse.net/github-enterprise-proof-of-presence-high-impact-actions-guide.md)