CakePHPで Auto Incrementを外すと Duplicate entry ‘0’ for keyのエラーが出るかも

2024/06/13 2024/06/21

CakePHPで「Duplicate entry ‘0’ for key」のエラーが出る不具合の事例

CakePHPで「Duplicate entry ‘0’ for key」のエラーが出た

　
CakePHP4で、コマンド処理の開発をしていたのですが、下記のエラーに遭遇しました。
　
2024-01-01 00:00:00 error: [PDOException] SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry '0' for key 'PRIMARY' in C:\xampp4\htdocs\vendor\cakephp\cakephp\src\Database\Statement\MysqlStatement.php on line 39
　
2024-01-01 00:00:00 warning: The connection is going to be closed but there is an active transaction.
　
　
CakePHPで開発をしているときにこのエラーが出た方は「Auto Increment」の設定を変更していませんか？
　
この記事では、そんな「Auto Increment」の設定を変更した場合に発生する不具合についての解説記事で、エラーメッセージからは想像しにくいエラーでしたので、記事にすることにしました。
　
　

CakePHPで Auto Incrementの設定を外したときに発生する不具合

　
そもそもこのエラーが発生する状況はあまり多くないと言えるでしょう。
　
通常、CakePHPで開発をするシステムのテーブルの「ID」は「Auto Increment」を設定して自動附番の設定になっているかと思います。
というか、CakePHP単体で動作しているシステムの場合は「ID」に「Auto Increment」を設定しない理由がないかと思います。
　
ですが、他システムと連動しているシステムの場合、他システム側で付番をするので、CakePHP側のシステムでは「Auto Increment」を外す方がいい場合があります。
　
そんな外部システムと連携するシステムを構築する中で、最初は「Auto Increment」を付けていたけど、途中で「Auto Increment」を外す、と言うような場面があったとします。
　
そんな時に発生します。
　
　
例えば「/src/Model/Entity/Users.php」の「$_accessible」は下記のようになっています。
　

  protected $_accessible = [
    'id' => true,

    'name' => true,
    'password' => true,
    'email' => true,
    'created' => true,
    'modified' => true,
  ];

protected $_accessible = [

'id' => true,

'name' => true,

'password' => true,

'email' => true,

'created' => true,

'modified' => true,

];

　
「Auto Increment」が設定されているときは、「ID」は自動付番されるため、「'id' => true,」は必要ないのですが、「Auto Increment」を外すと編集する項目として追加する必要があるのです。
　
ですが、「Auto Increment」を付けたり外したりする中で、「'id' => true,」を追記し忘れることがあるのです。
そうすると、先に紹介したようなエラーが発生します。
　
　
「Auto Increment」を外しただけなのでテーブル構造は変わっていないから、プログラムはほとんど変えないでいいだろう、みたいなことを思っていると陥りやすいような気がします。
　
　
「'id' => true,」が付いていないことで、「id」が処理されませんので、1件目は「ID：0」で保存されます。ですが、1件目は正常処理されます。
ですが、2件目も「ID：0」で保存されますので、2件目で先のエラーが発生するのです。
　
そのため、「1件目は正常なのになぜ？」みたいな疑問も起こるのです。
　
　
もちろん、「'id' => true,」を追加するのではなく、テーブルの設定の方に「Auto Increment」を追加してもエラーは解消します。
　
　

IDをプログラムの処理で発行する場合の不具合の事例

　
ちなみに「Auto Increment」を設定せず、「ID」をプログラムの処理で発行するときはこんなエラーもありました。
　
「ID」の付番をプログラムの処理で行っていましたが、処理した結果の「ID」が「a」などのアルファベットになっていました。
数値であれば問題ないのですが、アルファベットのため、数値に変換できずに「0」として保存されました。先の例と同じく 1件目は重複しないので登録できます。
2件目の処理で「ID：b」を登録しようとすると、「ID：0」となるため、「『0』は重複してますよ」と言うエラーになって登録できない、と言うような不具合もありました。
　
　
先にも書きましたが、CakePHPでシステム構築をする場合、「Auto Increment」を使わないことが少ないと思いますので、この記事で紹介した不具合に出会うことはかなり稀なことだと思います。
　
逆に、稀だからこそ記事が少ないと思いますので、万一同じ状況になった方のお役に立てれば、と思っています。
　
　

「Duplicate entry ‘0’ for key ‘PRIMARY’ in XXXXXX」のエラーの一般的な解消方法

　
「Duplicate entry ‘0’ for key ‘PRIMARY’ in XXXXXX」と言うエラーは
「『PRIMARY』となる『ID』が重複しています」
という内容のエラーです。
　
Googleで「Duplicate entry ‘0’ for key ‘PRIMARY’ in C」で検索して見た結果
　
Googleで「Duplicate entry ‘0’ for key ‘PRIMARY’ in C」を検索した結果が上記の URLの内容なのですが、「IDが重複しているので重複しないように処理しましょう」と言う内容のものが多々あります。
　
エラーの内容を素直に受け取るなら、IDが重複していますということなので、重複しないようにすることがエラーの解消方法ですからね。
ですが、往々にして、IDを指定していない（自動処理している）ために、IDに何が入っているのかがよく分からっていないときに発生する場面が多いですね。
　
IDに何が編集されているか、それを見極めながらデバッグをするしかなさそうですよね。
　
　

Auto Incrementに関連する不具合で Rollbackできなかったエラー

　
ちなみに「The connection is going to be closed but there is an active transaction.」の方のエラーは、「コネクションは終了していますが、トランザクションは残っています」と言うワーニングです。
　
これについては、トランザクションを「Rollback」して終わらせたり、MySQLなどのデータベースを再起動したり、と言った感じの対処療法的な解決策を提示する記事がありましたが、これも「Auto Increment」に関連して不具合が発生し、「Rollback」できなかったために発生している不具合だと言えますね。
　
　

- CakePHP 3.x 4.x 5.x CakePHP4

最後までお読みいただきましてありがとうございます。
この記事が参考になったと思いましたらソーシャルメディアで共有していただけると嬉しいです！

Message コメントをキャンセル

※入力いただいたコメントは管理者の承認後に掲載されます。

: CakePHP3でファイルのアップロード処理を自作・解説付き・その１

CakePHP3でファイルをアップロードする処理を、php.netにある「エラーを起こさない」と説明がある処理を参考に作成。サンプルソースとその解説付きで、コピペでも動くし、カスタマイズも簡単！

: CakePHP4、5の認証処理で認証が通らない際の確認方法と確認箇所の紹介

CakePHP4、5系の認証処理でログイン認証が通らない場合の確認方法、確認箇所を解説。ログ出力し、ステータスを確認するが、ステータスの内容も紹介。それはそのままusernameを変更する際のポイントでもある。

: CakePHP3ログファイルへの出力・$this->log()、独自ログへの出力方法の解説

コントロール、モデルの変数の中身を見るときはログに出力する方法が有効です。$this->log()を利用すると変数だけじゃなく、連想配列、オブジェクトも簡単にログ出力ができます。

: CakePHP3で画像・ファイルのアップロード処理を自作・解説付き・その２

ファイルのアップロード機能の自作サンプルコードとその解説のその２。アップロード機能に関連するファイルの更新や削除の処理や画像、フォルダのパスの指定方法などを含めて解説。

: CakePHP4でロギングスコープやログレベルを使用してログを出し分ける方法を解説

CakePHPのログ出力方法の解説。app.phpにログ設定をし、スコープやレベルを指定してログ出力を振り分ける方法、CakePHP4で配列出力にはvar_exportが必要なことなどを解説。

: CakePHP3でシェルを作成しコマンドラインから実行・CakePHP2との違い

CakePHP3のシェルスクリプトを作成し、コマンドラインから実行する方法を解説。複数単語をつなげる場合の対応方法がCakePHP2より制限が厳しくなったのでCakePHP3の命名規則の確認が必要だ。

: CakePHP4、5で$_SERVERと同じようにURIを取得する「getUri()」の紹介

PHPでサーバ情報、環境情報を取得する際は「$_SERVER」を利用するが、似たような情報をCakePHPの関数で取得する際は「getUri()」を使用する。取得出来る値は一致するものもあるが、違うものもあり便利な使い方もある。

: CakePHPのバリデーションを入力値・項目の条件によって変える方法を解説

入力された値によってバリデーション（入力チェック）の内容を切り替える。その処理をCakePHPで実装する方法を解説。条件ごとに unset関数を使ってバリデーションを削除する、という方法を採る。

: CakePHP3チュートリアルで日付と時刻のDateTimeでエラーが出たときの対処方法

CakePHP3のブックマークチュートリアルには記載ミスもあり、そのまま動かない個所もある。CakePHP3では namespaceを使うようになったので、classを呼び出すときに￥を追加する必要が！