先日，NAS (SAMBA) にあるファイル（フォルダ）が Mac から見えないという事象に遭遇しました。どうやら，Unicode の正規化形式に起因する問題であったようです。文字コードの正規化形式を変換して解決しました。

症状と原因

まず，今回の障害の症状と原因を整理しておきます。

症状

NAS (SAMBA) に保存されている一部のファイルが，Mac PC から見えない
同ファイルは，Windows/Linux からは見えている

原因

どうやら，このファイルのファイル名に使われている文字コード（正確には正規化方式）が NFD 形式であったためのようです。所謂，NFC/NFD問題（Unicode正規化形式の違いに起因する問題）と呼ばれるもので，MacOS で作成したファイルで起こりがちなようです。

NFD → NFC 変換

問題解決のために，ファイルの名前を UTF-8 (NFC) 形式に変換する Python のプログラムを作成しました。奥村晴彦さんのページを参考にしています。当プログラムを起動すると，起動プログラムと同じ階層とそれ以下の階層にあるファイル（フォルダ）の名称を UTF-8 (NFC) 形式に変換します。

rename_to_nfc.py

import os
import pathlib
import unicodedata

files = pathlib.Path('.').glob('**/*')
for file in files:
    filename = str(file)
    nfc_filename = unicodedata.normalize('NFC', filename)
    if filename != nfc_filename:
        print('Renaming ', filename.encode('utf-8'), 'to ', nfc_filename.encode('utf-8'))
        os.rename(filename, nfc_filename)

テストしてみます。
まず，テストに使用する NFC/NFD 形式のファイルを作成します。次のプログラムで作成できます。

gen_nfc_files.py

import os
import unicodedata

s = 'ヴィジブル'
s_nfc = unicodedata.normalize('NFC', s).encode('utf-8')

os.makedirs('nfc_files', exist_ok=True)
os.chdir('nfc_files')
with open(s_nfc, 'w') as f:
    pass

gen_nfd_files.py

import os
import unicodedata

s = 'インヴィジブル'
s_nfd = unicodedata.normalize('NFD', s).encode('utf-8')

os.makedirs('nfd_files', exist_ok=True)
os.chdir('nfd_files')
with open(s_nfd, 'w') as f:
    pass

NFC 形式の「ヴィジブル」と NFD 形式の「インヴィジブル」という名称のファイルが生成されます。この状態で Mac PC から NAS (SAMBA) にアクセスしても「ヴィジブル」しか見えません（今回の障害の主題です）。

先ほどの変換プログラムを実行してみます。

python rename_to_nfc.py

これですべてのファイルがNFC 形式に統一されたので「インヴィジブル」も見えるようになりました。

以上，Mac PC から NAS (SAMBA) のファイルが見えない問題を，文字コードの正規化形式を変換して解決しました。

NAS のマウント

話が前後しますが，そもそも NAS (SMB) にアクセスして上記の変換プログラムを起動するためには，ローカル PC にマウントできていなければならないはずです。NAS のマウントは以下のようにして行います。

MacOS の場合：

mount -t smbfs //user@smbserver/share ~/mnt/smb

Linux の場合：

sudo mount -t cifs -o uid=$(id -u),gid=$(id -g),username=user //smbserver/share ~/mnt/smb

感想

Unicode 正規化方式として NFD を採用しているのは Mac なのに，SMB (NAS) を介してみると当の Mac だけがそういったファイルを認識できない（ことがある）というのはなんとも皮肉な結果ですね...。