こんにちは、時短ギア管理人の清光です。

コードは書けない現役の営業ですが、AIと一緒に、現場が毎日使う業務システムを1年以上つくり続けてきました。

「前に直したはずのバグが、しばらくしてまた出てきた」。そんな経験はないでしょうか。

私の場合、それが同じ場所で、しかも1ヶ月あけてもう一度起きました。

この記事では、なぜ直したはずのバグが同じ場所で再発するのか、その仕組みと、再発防止の手順を紹介します。

深夜にキーボードを操作している手元

なぜ「タイムゾーンのバグ」が起きるのか

自作の業務ツールは、保存するときの時刻と、画面に表示するときの時刻が、内部的には違う基準で扱われていることがあります。

サーバー側は世界標準時(UTC)、画面側は日本時間(JST)、というズレです。普段は9時間の差があるだけなので気づきません。

ところが、深夜0時前後にデータを保存すると、このズレが「日付そのものが変わる」という形で表面化します。

日本時間では今日の23時でも、世界標準時ではもう翌日の14時、ということが起きるからです。

結果、同じ操作をしたはずなのに、別の画面では前日の日付として記録され、画面同士で食い違いが起きます。

実際に起きたこと

私が自作ツールを作り始めた最初の1週間、最初にハマったのがこのタイムゾーンのズレでした。

その場は原因を探して直し、以後は問題なく動いていました。少なくとも、そう思っていました。

ところが開発を始めて1ヶ月ほど経ったある日、週末にまとめて機能を作り込んでいたとき、またまったく同じ現象に出会いました。

深夜に保存した記録の日付が、別の画面では前日としてズレて表示されていたのです。

しかも、今回も最初にハマったのと同じ場所でした。

2つの画面を見比べながら原因を切り分ける様子
同じ場所で再発した原因を見比べる

なぜ直したはずなのに、また刺されたのか

こうした再発でよくあるのは、1回目の修正が「その場の症状」に対する直し方で終わっていることです。

日付がズレて見えた1箇所だけを個別に直し、時刻の変換そのものをシステム全体で1つにまとめていない、というパターンです。

その後、新しい画面や処理を追加したとき、また別の場所で同じ変換のミスを踏んでしまいます。

バグそのものは直っていても、「同じ種類のミスをまた踏める構造」は直っていなかった、ということです。

再発を防ぐ対策3ステップ

再発を防ぐには、次の3つがおすすめです。番号を振ってAIに渡し、1つずつ直してもらう形にすると進めやすくなります。

  1. 日付・時刻の変換処理を、システム全体で1箇所の共通処理にまとめる。画面やボタンごとに個別の変換コードを書かせない。
  2. 深夜0時をまたぐ時刻でデータを保存するテストケースを、あらかじめ用意しておく。
  3. 日付がズレる系の不具合が出たら、まず「前にも同じ場所で直したことがないか」を最初に確認する手順にする。

特に大事なのは1番目です。変換する場所が1つしかなければ、新しい画面を増やしても、同じ種類のミスを踏みにくくなります。

直し方効果
その場だけ直す一時的に直るが、別の場所で再発しやすい
変換を1箇所に集約新しい画面を増やしても再発しにくい

Q. なぜ最初の修正のときに気づけなかったのですか?

コードを自分で読めないと、AIが直した内容が「その場しのぎ」か「仕組みとしての修正」かを見分けにくいからです。

直すたびに「同じ種類の処理を他の画面でも使っていないか」をAIへ確認するのがおすすめです。

Q. 深夜に動く自動処理は何に気をつければいいですか?

深夜0時をまたぐタイミングは、日付のズレが一番出やすい時間帯です。そこだけ意識して動作を確認しておくと安心です。

Q. 一度直したバグがまた起きたら、どうすればいいですか?

まずは「前回、本当にその場しか直していなかったか」を疑うところから始めます。同じ場所をもう一度見るのは悔しいですが、一番近道です。

まとめ

  • 深夜0時前後の保存で、日付がズレる現象の多くはタイムゾーンの扱いが原因
  • その場だけ直すと、別の場所でまた同じ種類のミスを踏みやすい
  • 変換処理を1箇所に集約すると、新しい画面を増やしても再発しにくくなる

この考え方は、自分でコードを読めなくても「直し方の方針」として言葉にしておけば、AIに伝えられます。

コードが読めなくても不具合と向き合う方法は、こちらの記事でも紹介しています。

今日はここまで。

この記事が、あなたの時間を少しでも価値に変えるお手伝いになれば嬉しいです。

それでは、また次の時短ハックでお会いしましょう。

自作している業務システムのことや、お仕事のご依頼はお問い合わせからどうぞ。