初めに
この記事では、Difyのカスタムツール作成時に発生した「invalid input syntax for type uuid」エラーの原因分析と解決策を解説します。実際のエラーログ、修正手順、テスト結果を交えながら、具体的な対応方法を説明します。
エラーの発生状況
エラーログの例
2025-03-15 17:09:28 db-1 | ERROR: invalid input syntax for type uuid: "" at character 745
2025-03-15 17:09:28 db-1 | STATEMENT: SELECT accounts.id ... WHERE accounts.id = ''::UUID
2025-03-15 17:09:28 api-1 | sqlalchemy.exc.DataError: (psycopg2.errors.InvalidTextRepresentation) invalid input syntax for type uuid: ""
エラーの原因は、accounts.idのクエリパラメータとして空文字列が渡され、PostgreSQLがUUID形式に変換できなかったためです。特に、WHERE accounts.id = ''::UUIDの部分が問題の核心です。
解決策の実装（Pull Request内容）
対応内容
実装コードの例（Pull Requestより）
# api/models/tools.py
@property
def user(self) -> Account | None:
if not self.user_id:
return None
return db.session.query(Account).filter(Account.id == self.user_id).first()
修正と修正後の確認
環境構築手順
# Difyリポジトリのクローン
git clone https://github.com/langgenius/dify.git dify-main
cd dify-main/docker
# .envファイルの作成
cp .env.example .env
# docker-composeの修正（ローカルビルド用）
vi docker-compose.yaml
---
services:
api:
build:
context: ../api
dockerfile: Dockerfile
worker:
build:
context: ../api
dockerfile: Dockerfile
---
# コンテナの起動
docker compose up -d
テスト結果
修正後はエラーが解消され、適切なバリデーションが動作
参考リンク：
この記事がDifyの開発者コミュニティに役立てば幸いです！