
OpenAIの記事を動画にしてみた。
mulmocastでハマったPuppeteerエラーと格闘記録
事の発端
最近、mulmocastというツールでビジネスプレゼンテーションの動画を作ろうとしていたんですが、まあ見事にハマりました。
音声の生成は順調に進んだんです。audio 0から8まで、全部問題なしで「よし、これは楽勝だな」と思った矢先、画像生成でいきなりつまづく。
TimeoutError: Timed out after 30000 ms while waiting for the WS endpoint URL to appear in stdout!
なぜブラウザが絡んでくるのか、ようやく理解
最初は全然意味が分からなかったんですが、調べていくうちに仕組みが見えてきました。
mulmocastって、ただの画像を生成するだけじゃないんですね。特に今回作っていたビジネスプレゼンには棒グラフが含まれていて、これがくせ者でした。
現代のチャートって、静的な画像じゃなくてHTMLとJavaScriptで動的に作られるんです。データに応じて色やサイズが変わったり、アニメーションがついたり。でもそれをPNGやJPEGにするには、一度ブラウザで表示させる必要があるようです。
そこで登場するのがPuppeteer。バックグラウンドでChromeを起動して、そこでチャートを表示させてスクリーンショットを撮る、という仕組みらしいです。
WebSocketエンドポイントの謎
で、なんでタイムアウトするのか。
Puppeteerがブラウザを制御するには、まずChromeとの通信路を確立する必要があります。ヘッドレスChrome(画面に表示されないモード)が起動すると、「私はここにいるよ」という合図としてWebSocketのアドレスを標準出力に吐き出すんです。
Puppeteerはそのアドレスが表示されるのをじっと待っている。30秒待っても出てこないと「もういいや」とタイムアウトする、と。
原因を探る過程
なんでChromeが黙ってるのか調べました:
リソース不足:CPUやメモリが足りない
プロセスの競合:既存のChromeと干渉している
権限問題:macOSがPuppeteerの動作を制限している
並列処理の問題:複数の画像を同時生成中で、ポートの奪い合いが発生
実際、image 0から4まで並列で処理していたので、複数のChromeインスタンスが同じポート(デフォルトの9222番)を取り合っていた可能性が高そうでした。
試行錯誤の末に見つけた解決策
結局、3段階のアプローチで解決しました:
1. 状態のリセット
killall "Google Chrome" 2>/dev/null
とりあえず全部のChromeプロセスを強制終了。2>/dev/nullをつけたのは「プロセスが見つかりません」エラーを黙らせるためです。
2. 環境の明示的な指定
export PUPPETEER_EXECUTABLE_PATH="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
Puppeteerに「Chromeはここにあるよ」と教える。自動検索に頼らず、確実なパスを指定。
3. セキュリティ制限の緩和
export PUPPETEER_ARGS="--no-sandbox --disable-setuid-sandbox --disable-dev-shm-usage"
macOSの各種制限を回避。特に--no-sandboxは効果的でした。
コマンド実行時の小さなハプニング
実は最初、AIでコマンドを調べて、コメント行(#で始まる説明文)も一緒にコピペしてしまって:
zsh: command not found: #
なんてエラーが出ました。でも肝心のexportコマンド自体は正常に実行されていたので、結果オーライです。
echo $PUPPETEER_EXECUTABLE_PATHで確認したら、ちゃんと設定されていました。
学んだこと
今回の件で分かったのは:
表面的なエラーに惑わされない:コメント行でエラーが出ても、本質的な処理は成功していることがある
環境変数の威力:適切に設定するだけで、複雑な問題があっさり解決する
ブラウザ自動化の仕組み:WebSocketベースの通信、ヘッドレスモード、プロセス管理など
この知識、Puppeteerだけじゃなく他の場面でも使えそうです。基本は同じでプロセスリセット→環境設定→権限調整が重要と思いました。
終わりに
結果的に、無事にプレゼンテーション動画が完成しました。OpenAIのStargate Norwayについての内容で、LinkedIn投稿用の動画として使う予定です。以下YouTubeのリンクです。
https://youtu.be/MZxUCR_MAfo
技術的なトラブルって、解決した後から振り返ると「なんだ、そんなことか」って思うんですが、渦中にいる時は本当に分からないものですね。今度同じようなエラーに遭遇したら、もう慌てることはないでしょう。