djangoのFileFieldにアップロードしたファイルのファイル名から空白や記号が消える

Question

実現したいこと

djangoのFileFieldにアップロードしたファイルのファイル名の空白や記号が勝手に消えるのを防ぎたいです。
またなぜ消えるのかを知りたいです。

発生している問題・分からないこと

djangoのFileFieldにアップロードしたファイルのファイル名から空白や記号が勝手に消えて保存されます。
【例】(新規)0001～0002　20250114.pdf　→　新規0001000220250114.pdf

該当のソースコード

特になし

試したこと・調べたこと

• teratailやGoogle等で検索した
• ソースコードを自分なりに変更した
• 知人に聞いた
• その他

上記の詳細・結果

ネットで調べてみましたが同じような問題で悩んでいる人や解決策が見つけられませんでした。

補足

特になし

Answer 1

ファイル名が勝手に変更される原因と対策

DjangoのFileFieldでアップロードしたファイル名から空白や記号が消えるのは、内部でget_valid_filename()関数がファイル名を安全な形式に変換するためです。

原因:

get_valid_filename()関数は以下の処理を行います。

• 先頭と末尾の空白を削除
• 空白文字をアンダースコア (_) に置換
• 英数字、アンダースコア、ハイフン、ドット以外の文字を削除

これにより、括弧やチルダ、全角スペースなどが削除され、ファイル名が連結されます。

対策: 元のファイル名を保持する

FileFieldのupload_toパラメータに関数を指定することで、元のファイル名を保持できます。

from django.db import models

def upload_path_handler(instance, filename):
    return f'uploads/{filename}'

class MyModel(models.Model):
    file = models.FileField(upload_to=upload_path_handler)

注意点:

元のファイル名を保持する場合、以下の点に注意が必要です。

• URLエンコーディング: 空白や記号を含む場合、URLアクセス時にエンコーディングが必要になることがあります。
• ファイルシステムの制限: 特殊文字はファイルシステムでエラーの原因になる可能性があります。
• セキュリティリスク: 悪意のあるファイル名によるセキュリティリスクも考慮が必要です。

推奨される対応:

完全に元のファイル名を保持する以外に、以下の方法も検討できます。

• 元のファイル名を別フィールドに保存: 表示用として元のファイル名を保存する。
• 空白をアンダースコアに置換: URL問題を避けつつ可読性を保つ。

Comments

[kuromi_f]

わかりやすく説明していただきありがとうございます。変換される文字が具体的にわかり、また対応の仕方まで教えていただき大変助かりました。推奨される対応を試してみます。