メインコンテンツへスキップ
見出し画像

【Mac民向け】VRChatワールド開発でハマった通信エラーの正体 〜FDとMonoの話〜

    この記事で分かること

    • MacでVRChat開発中に多発した「謎の通信エラー」の正体

    • なぜWindowsでは起きなくてMacでは起きるのか

    • 今すぐできる対処法

    • 【コラムいくつか】根本解決にまつわる最新ニュース

    忙しい人向けまとめ

    1. Macで Could not register to wait for file descriptor が出る

    2. 原因はMonoの select() が持つFD 1024番の壁(アセットは無罪)

    3. Editor再起動で復帰。頻発するならWindowsでテスト

    また極力、Unity初心者・VRChat開発初心者の方でも読めるように、
    専門用語はできるだけかみ砕いて解説しているつもりです…


    開発中に起きた事件

    私はVRChatを嗜んでおりまして、私が日頃好んで使っている「Nemo」というアバターの隠れ家的ワールドの開発を進めております。

    開発途中のワールドの様子↓(説明も若干含まれてます。)


    そんな中、このワールドに YamaPlayer(動画プレイヤーのアセット)を導入したところで困ったことが起きました。

    導入したあと、「さてVRCにアップロードしようかなー」と思ってVRCのコントロールパネルを開いたら、VRChatへの通信まわりでエラーが多発し、
    ログイン認証やワールドのアップロードができなくなるという状態に陥ってしまったんです。

    「あれっ…VRCまた落ちた?」

    最近、デバッグ中にVRChatのサーバーダウンでアップロードができなかったことがあったばかり。
    ただ、現在のステータスを確認するも平常通りの運転。

    「助けてよ〜AIくん〜」

    と協力を仰ぎつつ、一緒に調べていくと

    アセットとはまったく関係がなくて、
    めっちゃ根深い問題に引っかかってしまった
    ということがわかりました。


    遭遇したエラー

    エラーメッセージは下記の通り。

    System.NotSupportedException: Could not register to wait for file descriptor 1217
      at BestHTTP.PlatformSupport.TcpClient.General.TcpClient.Connect
      at VRC.Core.APIResponseHandler

    メッセージ内容を意訳すると「ファイルディスクリプタ 1217 を監視対象として登録できませんでした。」となります。

    「ふぁ?ファイルディスクリプた?何だそれ?」

    ※ちなみにこのリアクションしてる本人は現役SEです。
    (ベテラン勢に叱られるレベル)


    ファイルディスクリプタ って?

    このファイルディスクリプタは、整理券をイメージするとわかりやすいです。

    整理券に通し番号が振られていて、返却するとその番号はまた使えるようになるような仕組みを思い浮かべて下さい。

    パソコンの世界でも同じことが起きていて、プログラムが「ファイルを開く」「インターネットに接続する」といった操作をするたびに、OSがこの通し番号付きの整理券を1枚発行します。

    この整理券が「ファイルディスクリプタ(File Descriptor / FD)」です。

    ポイントは2つ。

    1. 通信でもこの整理券を消費する — ファイルだけでなく、ネット接続も同じ仕組みで管理されています

    2. 返さないと番号が増え続ける — 接続を閉じ忘れると整理券が回収されず、番号だけがどんどん大きくなっていきます

    さっきの file descriptor 1217というのは、「1217番目の整理券」という意味だったわけです。

    この4桁の数字はエラーするたび毎回微妙に変わっていました。
    (1217、1214、1131…)

    どれもとある数値より少し大きい数字という共通点があります。ここに大きなヒントがありました。


    真犯人は「1024」という古い上限

    今回のエラーのポイントとなるのは、UNIX系OS(Mac、Linux)にある、select() という古来の仕組みです。

    select() は「今どの接続が通信可能になったか」を監視する役割を持っているのですが、この仕組みには設計当時から ”FD_SETSIZE = 1024”
    という上限がハードコードされて
    います。

    つまり、整理券の番号が1024を超えると、”select()” は「そんな番号は管理できません」とエラーを返すという状態になります。

    エラーに出てきた数字が全部1024より少し大きかったのは、まさにこれが理由でした。

    何で急に昔のUnix/macOS時代の話が登場してきた?
    と思うべきでしょうが、その理由は後で説明します。

    今回のエラーが発生するまでの流れ

    結果的に言えば、YamaPlayerなどの特定のアセット上の不具合ではありません。

    1. YamaPlayerのような重ためなパッケージを導入したことで、Unity側で扱うファイルディスクリプタが増えた。

    2. ファイルディスクリプタが通信の監視で扱える上限(1024)を超える。

    3. VRChatのコントロールパネルを開く際に発生するVRChatのサーバとの通信で、上限超過の通信エラーが発生した。

    おそらく、こうなっていたんじゃないのかなと(たぶん)。

    注意点:”ulimit” を上げても直らない

    ちなみに、今回のエラーは、ネットで検索すると「macOSの ulimit(同時に開けるファイル数の上限)を上げれば直る」という情報が出てきます。

    AIくんも最初、このファイル数上限が原因と見て、同じ改善案を提示してきて、実際に試しました。

    が、結果として、直りませんでした。

    # /Library/LaunchDaemons/limit.maxfiles.plist を作って
    # soft 8192 / hard 81920 に引き上げ
    launchctl limit maxfiles

    この ulimit は「整理券を何枚まで持てるか」の上限です。
    (元々この上限もかなり低めに設定されてるため、最初この上限値を超えたことによるエラーが発生していました。)

    一方 FD_SETSIZE=1024 は通信の監視を行ううえで「整理券の番号が何番までなら管理できるか」の上限で、この2つは別物です。


    なぜ古い仕様が今?

    (私使ってるの最近のmacOSだけど…?)

    そんな上限がなぜ今になって露呈したのか?

    そのためには、Unityで使われている「Mono」というC#を動かす基盤のことを知る必要があります。

    C#ランタイム「Mono」と通信の仕組み

    Unityは、macOSでもWindowsでも動かすために、
    Monoと言うランタイム基盤を利用しています。

    このMonoでクロスプラットフォームを実現しているわけです。

    「え?じゃあどっちのOSでも動くものなら、なおさら、なんでMacだけエラーが発生するの?」という疑問が湧きますよね。

    macOSではエラー、Windowsでは発生しない理由

    答えは、通信部分の実装は、OSごとに別物になっているからです。

    画像
    Unityで利用してるMonoの構造

    ↑ Windowsはさっきの整理券に「連番」を使う仕組みですらなく、「1024の枠」という構造的な制約が最初から存在しません。
    さらにいえばMono自身も、Windowsではより新しくスケーラブルな仕組みを使うように実装されています。

    Monoの設計思想

    クロスプラットフォームといえど、通信部分の実装がOSごとに別々の実装となっているのは、Monoは「そのOSの流儀」に合わせて作られているからです。

    いわば「郷に入っては郷に従え」と言うやつです。

    MonoはC#をいろんなOSで動かすための仕組みですが、ソケット通信のような低レベルな部分は、独自に開発せずOSが用意している標準の仕組みをそのまま使う設計になっています。

    • macOS / Linux → この2つはどちらも「Unix系OS」の血統。
      Unix系には BSDソケット という1980年代から続く共通の作法があり、
      通信の待ち受けには伝統的に select() を使う。

    • Windows → Unix系の血統ではないため、独自の WSAEventSelect や Overlapped I/O を使っている。

    OS標準の仕組みを使えば、
    そのOS向けに最適化されたバグの少ないであろう実装をそのまま活用でき、
    改めてローレベルな実装を行う労力を削減できるためです。

    なので、macOSがこの古い仕組みをわざと残しているのではなく、Unityが利用している基盤のMono側でこの古い仕様を利用しているために、互換性の観点から残ってしまった仕組みなのです。

    この仕様、どうにかならない?

    本来ならMono側で、古いOSの仕様ではなく別の実装に変えてくれていれば…って思いますよね。

    実際 select() を、macOSでより効率的な監視方式(poll() や kqueue など)に置き換える改修は、技術的には十分可能だと言われていますが…

    1. 問題が指摘された頃、Monoの開発ペースがちょうど落ち始めていた
      この古い仕様に指摘(Issue #15931)が上がった時期、既にMonoは下火で、開発の主力では無くなってきていたと言われています。
      その結果、Monoプロジェクト本体は、最後の大型リリースが 2019年7月、最後のパッチも 2024年2月 で事実上停止。
      開発の主体は WineHQ という別団体に移管されて、互換性を維持する最低限のサポートのみ続くのみとなっているそうです。

    2. UnityもMonoから置き換える方針に
      Monoを利用している側のUnityも実は数年前から、Monoよりも現代的な CoreCLRに移行する方針 に切り替わっていたそうです。
      そのため、Mono自体を修正する優先度はおそらく低いかと…

    この1024の壁は(Unityのランタイム上の話で言えば)、修正されるより先に、後々置き換えられて消える運命になった、というのが今の流れです。

    ちなみに、Unityがこのランタイム置き換えに関して、私の耳にはこれまで入ったことはなく、VRChatで主流となっている Unity2022.3.22f1 はもちろん、最近のUnity6でもまだ完全に置き換わってはいません。

    そう、Unity6ではまだ…


    「………………………………マジかぁ😫」

    VRChatだけの問題でもなく…

    ちなみに今回のエラーは「macOS上で通信を伴う処理を多く・長く・並行して行うUnity開発」全般に共通する、構造的な問題です。

    発生はごくまれと思われますが、以下の条件が重なるほど発生しやすくなると見ています。

    • 通信系のSDK/プラグインを多用している

    • Editorを長時間再起動せずに使い続けている

    • ネットワーク要素の多いプロジェクト(マルチプレイ、オンライン機能)

    • 依存パッケージが多い / 自動更新チェックが多い

    • Mac上でCI/自動ビルドを回している など


    今すぐできる対処法

    残存している仕様なので根本解決はできませんが、発生頻度を下げる、もしくは回避する方法は存在します。

    対処法①:こまめにUnity Editorを再起動する

    Editorを再起動するとファイルディスクリプタの番号がリセットされるので、一時的に通信が復活します。
    VRChatの場合で言えば、アップロード直前に再起動すると解決することが多いです。

    上記で解決しない場合は、次項の②、③と試してみてください。

    対処法②:通信系プラグインを減らす

    ファイル監視や通信を裏で行うアセットが多くなると、ファイルディスクリプタの割り当てが多くなります。使っていないものは除外するのが良いかもしれません。

    対処法③:通信部分のテストなどはWindowsでやる

    ほんとに頻発するようなら、OSを切り替えるのが確実です。
    (身も蓋もないですが…)

    制作はmacOS、テスト機(主に通信用)をWindowsとすれば、ついでに両環境でテストできると思えば一石二鳥です。

    特にVRChatは、Windowsであればネット同期のテストも簡単ですから、
    テスト用としてWindowsに開発環境を用意しておくのもかなり実用的といえます。

    対処法まとめ

    macOSでVRChatワールド開発をする場合、YamaPlayerに関係なく今後も遭遇する可能性がありますが、逆に言えば、原因さえ分かっていれば「あぁ、またアレかぁ」と思えば良いかと。

    ファイルディスクリプタ関係で通信エラーが発生したら、Editor再起動を試す。もし、どうにもならなければWindows側でテストする。

    — これさえ覚えておけば、だいたいなんとかなるんじゃないかなと…

    なので、私もおとなしくVRChatのアップロードとテストだけ、
    Windowsに移行するようにします…

    もしかしたら別の対処法があるのかもしれませんが、
    もし、同じようなエラーが発生した方がいるようであれば、
    この対処法が参考になってくれると嬉しいです。


    【コラム①】MacユーザーのVRChat開発事情

    今回のエラーに限らず、今後macOSでVRChatのワールドやアバターの開発をし続けるには、現状ちょっと厳しめの環境ではあります。
    (不遇とまでは言えませんが…)

    VRChatのクライアントを利用したテストが出来ない

    先ほどもWindowsだと同期のテストも簡単と言った理由でもあります。VRChatがインストールされているWindowsであれば、Unityから直接VRChatを呼び出しつつ、Unityのコンソールでログを見ながら、2つ以上のユーザーがいる状態を再現してテストができます。

    ただ、Mac版のVRChatが存在しない以上、macOSだけで全て完結とまでいかないのは、致し方ないと思えます。

    ただ、次の方が若干影響度高くて…

    現在のVRChat SDKがIntel専用Unity(Rossetta)に依存している (影響度高め)

    Mac上では、VRChat SDKが使えるUnity2022.3.22f1は、実行にRosettaによるIntelエミュレーションが必要です。(これは、エディタがAppleシリコン対応となっていても、内部のPackage Managerなどの機能の動作はIntel依存であるためです。)
    しかし、このRosettaが「どんなIntelアプリでも動かしてくれる」状態でいられるのは macOS 27が最後となり、macOS 28以降は一部の古いIntel製ゲーム向けにしか機能が残りません(Apple公式)。
    そうなると同じ時期にSDKが動かなくなってしまう可能性があります。

    ただし、最近、「VRChatがUnity 6対応のオープンベータ(unity-6 ブランチ)を開始した」と発表があったため、もし、開発がUnity6で可能になれば解決する可能性があると思うので、今後の展開に期待です。

    とはいえ、先のようにテスト環境的にはWindowsが適しているため、macOSを主軸とし、Windowsをテスト機とした運用を続けつつ、Rosettaのサポート終了に備えるのがマストかと思います。

    2026/9/18 追記事項

    つい最近リリースされた、macOS 27 Golden Gateですが、どうやらアップデート直後はRosettaが消えているため、この状態でUnity2022.3.33f1を起動しようとすると、起動時にフリーズしてしまう症状が発生しました。

    softwareupdate --install-rosetta --agree-to-license

    そのため、ターミナル上で上記のコマンドを実行し、Rosettaの再インストールを実施することで解消できました。


    【コラム②】
    あれそういえば Unity 7 発表されたよね…?

    ここで、Unityに関する最近のニュースの話になりますが…

    ちょうどこの問題が発生した頃に、最新のUnity7のロードマップが発表されていました。(2026年7月20日)

    Monoからとうとう脱却!?

    • Faster Creation: Built on a modernized core utilizing CoreCLR, Unity 7 accelerates every aspect of the development pipeline. The platform will include a near-instant Play Mode, domain reloads that touch only the code that changed, and shader builds that are up to 90% faster, keeping developers in their creative flow.

    <日本語訳>
    ・より速い制作:Unity 7は、CoreCLRを活用した近代化されたコアを基盤としており、開発パイプラインのあらゆる面を高速化します。このプラットフォームには、ほぼ瞬時に起動するPlay Mode、変更されたコードのみに影響するドメインリロード、最大90%高速化されたシェーダービルドが含まれ、開発者が創作の流れを維持できるようにします。

    とうとう、Unity7からはMonoからの脱却になるようです。
    Monoを使わなくなるということは、すなわち1024の壁問題に今後悩まされることもなくなる
    と言うことですから。

    「なんともタイムリーな…」

    しかも、CoreCLRってめちゃくちゃ処理が早いらしいんですよね。

    また、発表の中にはこんな記述もありました。

    • No Breaking Changes: Unity 7 is a direct continuation of the Unity 6 architecture. The upgrade path requires zero rebuilding; all projects, skills, and code will carry forward smoothly into the next generation.

    <日本語訳>
    ・破壊的変更なし:Unity 7は、Unity 6アーキテクチャの直接的な延長です。アップグレードに再ビルドは不要で、すべてのプロジェクト、スキル、コードは次世代へスムーズに引き継がれます。

    一般的には、メジャーアップデート(バージョン1.0から2.0に上がる時)は、これまでの機能が使えなくなるため、開発で利用する側がアップデートに対応する必要があります。

    ですが、今回のUnity7のアップデートは、Unity 6機能そのままに中身がゴッソリCoreCLRに置き換わってくれるので、開発側で対応させる必要がほぼ無いのです。

    Unityでの開発に集中できる意味では、こうしたアプデはめちゃくちゃありがたい…🙏

    とはいえ、Unity7の正式リリースは2027年初頭の予定です。
    VRChat側の対応はもっと先と考えると、
    まだまだワールド開発でMonoとはおさらば、とはならないですが…

    UnityならびにVRChatでの今後が楽しみですね。



    ずいぶん長くなってしまいましたが、
    最後まで読んでいただきましてありがとうございます。

    ワールド開発も引き続き頑張ります。


    それでは 👋


    <参考リンク&関連記事など>

    ※ AIが引用してきたページも含まれてます。英語ばかりなので翻訳推奨です。

    エラーに関する情報

    VRChatに関する情報(公式)

    Unity 7 / CoreCLR ロードマップ


     
     
    Unityでゲーム作りを趣味にしている、独身サラリーマンです。

    あなたへのおすすめ