Automation

半年止まっていたScanSnapの取り込み

レシートを無人で取り込む仕組みを組んで、毎朝「流せます」と緑を出していました。ところが半年のあいだ、一枚も取り込めていませんでした。緑の判定条件に、スキャナ側の状態が入っていなかったためです。

2026.10.11 公開読むのに約 6分約 3,700字
この記事の内容
  1. 『自分が動けるか』しか見ない緑
  2. 変わるIPアドレスを古いまま呼ぶ監視
  3. 紙を吸い込んでもつながらないスキャナ
  4. ポーリングで壊した接続
  5. 未確認の扱い
  6. 生きているのに処理を止めた常駐プロセス

レシートを1枚差してボタンを押すとスキャナが読み取り、PDFがネットワークの保存先へ自動で届く。無人の取り込みをこうした形で組み、毎朝「今日も流せます」という緑の表示を出していました。ところがある日まとめて数えてみると、半年のあいだ、正確には178日ものあいだ1枚も取り込めていなかったのです。その期間も「今日も流せます」の緑は毎朝表示されていて、私はそれを見て問題なしと判断していました。

『自分が動けるか』しか見ない緑

よくある緑のランプは常駐プロセスが動いているかを確認しているだけで、相手の機器まで処理が届いたかは条件に入っておらず、今回の取り込みも同様の作りでした。

半年気づけなかった原因は判定の条件にあり、毎朝の「流せます」はこちら側のMacが組み上がっているかどうかしか確認していませんでした。常駐プロセスが動いているか、設定がそろっているか、保存先につながるかの3点はどれも問題がないので緑が出ますが、肝心のスキャナが実際に読み取れているかは一度も見ていませんでした。スキャナと半年通信できていなくても、Mac側の3点がそろえば緑が出る作りだったわけです。

修正ではアプリが持っている取り込みの記録から最後に成功した日時を読み、そこから14日が過ぎていたらネットワーク上にスキャナが見えても「流せます」とは言わないようにしました。スキャナには直接問い合わせませんが、これは制御用のポートに接続すると人が手で取り込むときの接続とぶつかるためです。

緑が見ていたもの(直す前)緑が見るようにしたもの(直した後)
常駐プロセスが動いているか最後に取り込めたのはいつか
設定がそろっているかスキャナが最近ネットワークに応えたか
保存先につながるか14日以内に一枚でも通ったか
直す前の3項目はどれもMac側の確認で、スキャナが止まっていても緑になりました。直した後の3項目は、スキャナが実際に動いたかを記録から確かめます。

変わるIPアドレスを古いまま呼ぶ監視

原因を追うとスキャナのIPアドレスに行き着きました。うちのネットワークは集合住宅の共用回線で、スキャナに割り当てられるアドレスは1時間ほどで入れ替わります。けれど設定には、ある日取れた古いアドレスが残っていて、そのアドレスを呼び続けていました。相手はとっくに別のアドレスへ移っているのでつながりません。しかも古いアドレスは設定の2か所に書かれていて、片方だけ直してももう片方が残り、また無効なアドレスを呼んでしまいます。

さらに、つなぎ直すとアプリが自分で、接続時のアドレスを設定へ書き込み直します。アドレスは1時間でまた変わるので、対処しなければ必ず再発する形でした。そこで、設定ファイル全体をたどって、スキャナを指すアドレスの記述を全部、いまの正しいアドレスに書き直すものを用意しました。記述の場所はハードコードせず、数が増えても拾えるようにしてあります。ひとつだけ条件をつけました。スキャナと接続している最中は、設定を書き換えません。取り込みの途中で接続を切ってしまわないためです。この仕組みは、のちに一度だけ自動で動きました。設定のアドレスと実際のアドレスがずれたのを見つけて記述を両方書き直し、常駐プロセスの再起動まで、人の操作なしで済ませています。

紙を吸い込んでもつながらないスキャナ

スキャナが通信できる状態かどうかは、本体の動きを見ても分かりません。給紙口に紙を差すと吸い込むので起動していると思ってしまいますが、本体がスリープしかけた中途半端な状態があり、このときは無線のチップだけが応答を返します。ネットワークの応答履歴には出るのに実際の通信はつながらず、しかもスキャナはスリープから復帰するたびに別のIPアドレスを取得します。アドレスは1時間で切れ、監視は数分おきにポーリングするので、短い復帰の合間に間に合わないこともありました。

ポーリングで壊した接続

調べている途中で自分の失敗もありました。スキャナの死活を確かめようと通信ポートを一秒ごとに叩くスクリプトを動かしていたのですが、このスキャナは一度に一台としか接続できません。こちらが毎秒接続しにいくたびに、本来の取り込み用の接続を横から奪っていたことになります。そうして得た「接続が二、三秒で切れる」という観測を故障の証拠として報告してしまいましたが、接続を切っていたのは自分のスクリプトでした。

このスキャナは、確かめるための接続自体が状態を変えてしまいます。そのため確認には、スキャナに接続せずに読める方法だけを使うことにしました。具体的には、次の3つです。arpで見るネットワークの応答の履歴、lsofで見るソケットの一覧、それに取り込みの記録の台帳を mode=ro の読み取り専用で開くことです。3つともスキャナへの接続が発生しないので、取り込みとぶつかりません。台帳のsqliteは、immutable=1 で開くと -wal を読み飛ばして直前のスキャンが見えなくなるため、mode=ro で開きます。nc -z で制御用のポート(53218〜53220)を叩くのは、確認の手段から外しました。

スキャナの状態の見方影響
制御用のポートを叩いて確かめる接続を奪う。観測が故障を作る
ネットワークの応答履歴を読む触らない。安全
開いているソケットの一覧を読む触らない。安全
取り込みの記録を読み取り専用で開く触らない。安全
このスキャナは一度に1台としか通信できないため、確認のための接続でも取り込みが切れます。表の下3つは、スキャナに接続せずに読める方法です。

未確認の扱い

もうひとつ、誤報もありました。ある朝、照合処理が「保存先に実物が無いレシートが350件ある」とアラートを出しましたが、全部まちがいで一枚も欠けていません。原因は、権限の問題でフォルダの中身を一覧できなかっただけなのに、sscommon.search_dirs() が except OSError: return [] で受けて「人が作った分類フォルダは0個」と返したことでした。空と読んだので、分類フォルダにあった354件のうち350件が「消えた」に数え替わりました。

同じ勘違いは配送側の forward.py にもあり、こちらは実害につながる場所でした。人が法人フォルダへ動かしただけの状態を「消えた」と読んでしまうと、すでに届いた紙をもう1本送ってしまいます。直し方は、一覧に失敗したときに「空」と決めつけないことでした。失敗したときは [] でなく None を返して「わからない」として扱い、数え落としたら照合ごと放棄して -1 を返します。一覧に失敗した場合とフォルダが本当に空の場合は、別の結果として返すようにしています。

生きているのに処理を止めた常駐プロセス

復旧したあとにも、似た落とし穴がありました。ある晩、レシート65枚を順調に読み込んでいた常駐プロセスの SshResident が、20:11:13を最後に吸い込みを止めました。macOSのログを log show で読むと、DoStartScan に No paper が返ったところで途切れています。薄いレシートがセンサーに軽く触れて、うまく掴めなかっただけです。それでも、そこから復帰できず、6時間47分、スキャナと一度も通信しませんでした。プロセス自体は終了しておらず、19日間生き続けていました。監視の guard.sh は pgrep -x で死活しか見ていなかったので、固まって動かない常駐プロセスを、問題なしと報告し続けました。固まった常駐プロセス自体は、止めて再起動すれば戻ります。そのため、固まったと判定する条件を先に決める必要がありました。いまは、プロセスの死活に加えて、ログに startPaper is Failed が続けて出たら、scanproc_rescue.py の check_failing_scan() が拾います。再起動は自動にせず、手で kill して起動し直しています。

直したあと、紙を一枚差してボタンを押すと2分半ほどでネットワークの保存先にPDFが届き、半年ぶりの取り込みとなりました。ボタンから保存先までエンドツーエンドで通ったのを確認できたのは、これが初めてです。この一枚はあとで取り込みの記録とも突き合わせて、サイズまで一致しています。

まだ確かめ切れていないのは、再起動をまたいでも同じように動くかです。ログイン時に常駐プロセスが立ち上がる設定も、保存先の資格情報も、人の入力が要らない形にはしてあります。ただ、自前で署名したアプリに与えた権限が再起動後も効くかどうかは、電源を入れ直して紙を通すまで分かりません。この項目は未確認として残し、実機で試したら結果をこの記事に追記します。

今回いちばん効いたのは、緑の判定条件をスキャナ側の記録に切り替えたことでした。止まったこと自体はアドレスの記述を書き直せば直る故障ですが、178日も気づけなかったのは止まったあとも緑が出続けていたからです。人が毎日は見ない処理ほど、この判定条件が無いと停止に気づくまでの日数が延びてしまいます。いまの緑は取り込み記録の日付を読んで14日と比べるだけの仕組みで、スキャナが応えているときにしか出ません。

弊社がお客様の業務に自動化を導入するときも、緑の判定条件を最初に決めてから作成します。「動いているはず」で進めるのをやめて、相手が最後に応答した時刻から状態を出力するようにしています。