MySQLでの『エラー1554: Truncated Incorrect DOUBLE Value』を解決する方法

このエラーは、文字列と数値の比較が行われたときにMySQLが文字列を数値へ自動変換できず、不正な変換として扱われた際に発生する。SQLの条件式やWHERE句、ON句などで予期せぬ型変換が発生しているケースが多い。この記事では、エラーの発生原因とその対処法を具体例と共に整理する。

エラーの内容と発生条件

Error Code: 1292. Truncated incorrect DOUBLE value: 'example'
-- または
Error Code: 1554. Truncated incorrect DOUBLE value

このエラーは次のような条件で発生する：

• WHERE句などで数値と文字列を直接比較している
• 比較対象が明示的な数値であり、文字列が数値に変換できない
• STRICT モードや TRADITIONAL モードが有効な場合により顕著に表れる

再現例：文字列と数値の比較

SELECT * FROM products WHERE price = 'abc';

この例では、price が数値型（例：DOUBLE）であり、比較対象が「’abc’」という文字列のため、MySQLは’abc’を数値に変換しようとし、結果として「不正なDOUBLE値の切り詰め（Truncated Incorrect DOUBLE Value）」エラーが発生する。

原因1: 型の不一致による比較

文字列を数値と比較すると、MySQLは自動的に暗黙的な型変換を行う。この変換が不正な場合、今回のようなエラーが出る。

-- 例：price が DOUBLE 型、'abc' は文字列
WHERE price = 'abc'

-- 暗黙の変換結果：'abc' → 0（不正変換とみなされる）

解決策1: 型を明確に分けて比較する

文字列は文字列同士で、数値は数値同士で比較することが重要。

-- 間違った比較
SELECT * FROM products WHERE price = 'abc';

-- 正しい比較
SELECT * FROM products WHERE product_code = 'abc';

比較の相手がどのような型かを事前に確認することが必要。

解決策2: CAST関数で明示的に型変換する

必要に応じて、CAST() や CONVERT() を使って型変換を明示的に行う。

-- 文字列を数値として比較する場合
SELECT * FROM products WHERE price = CAST('100.5' AS DECIMAL(10,2));

ただし、変換できない文字列に対してCASTを使うと依然としてエラーが発生するため注意が必要。

原因2: WHERE句における誤った比較ロジック

以下のようなケースでも同じエラーが発生する。

SELECT * FROM orders WHERE status = 1;

status が実は ENUM('pending', 'completed') 型だった場合、1という数値とENUM文字列との間で不正な比較が起こる可能性がある。

解決策3: データ型に合わせて条件式を書き直す

カラムが ENUM や VARCHAR 型であるなら、比較値も文字列として扱う必要がある。

-- 不正な比較
WHERE status = 1

-- 正しい比較
WHERE status = 'completed'

原因3: ON句でのJOIN時の比較ミス

SELECT * FROM products p
JOIN categories c ON p.category_id = c.name;

このように、数値型の category_id と文字列型の name を結びつけると、同様の型変換エラーが発生する可能性がある。

解決策4: JOIN条件も型一致にする

-- 正しいJOIN条件
JOIN categories c ON p.category_id = c.id;

結合条件では、双方の型が一致していることを確認しておく。

補足: SQLモードの影響

MySQLの sql_mode が以下のように設定されていると、より厳格に型エラーを検出する。

SELECT @@sql_mode;
-- 出力例:
STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION

-- 一時的に緩和したい場合
SET SESSION sql_mode = 'NO_ENGINE_SUBSTITUTION';

ただし、これは一時的な対応にとどめるべきで、本質的な問題の解決にはならない。

補足: 暗黙的型変換に注意すべき理由

MySQLは型が異なる値同士を比較したとき、内部で自動的に片方の型へ変換を行うが、予期しない変換により意図しない結果やエラーが発生する。常に比較対象の型を明確に把握しておく必要がある。

まとめ

「Truncated Incorrect DOUBLE Value」は、MySQLにおける自動型変換により、文字列が正しく数値に変換されないときに発生するエラー。SQL文内での比較対象の型に注意を払い、明示的な型一致を意識することで回避できる。曖昧な比較やJOIN条件を避け、データベース設計やクエリの記述を見直すことが根本的な解決につながる。