[{"data":1,"prerenderedAt":592},["ShallowReactive",2],{"h2886693544":3,"h785428029":376,"h729404648":582},{"id":4,"title":5,"body":6,"description":28,"extension":366,"meta":367,"navigation":371,"path":372,"seo":373,"stem":374,"__hash__":375},"docs\u002Fja\u002Ftips\u002F2026\u002F05\u002F07\u002Fline-launch-issue.md","「LINEで開く」や「LINEでログイン」がうまく動かないときに知っておきたいこと",{"type":7,"value":8,"toc":336},"minimark",[9],[10,11,12,20,25,29,38,41,44,47,50,55,58,85,88,91,95,104,114,122,125,143,148,151,154,158,161,164,167,174,178,181,184,194,197,203,207,210,213,226,229,235,243,247,254,257,263,270,314,317,321,324,327,330],"Tips",{},[13,14,17],"h1",{"id":15,"class":16},"","!mb-4",[18,19],"page-title",{},[21,22],"display-date",{"date":23,"class":24},"2026\u002F05\u002F07","!mb-20",[26,27,28],"p",{},"みなさんはLINEミニアプリを利用した際に「LINEで開く」ボタンを押してもLINEが起動しなかった、といった経験はありませんか？",[26,30,31],{},[32,33],"img",{"alt":15,"className":34,"src":37},[35,36],"border","w-fix-240","\u002Fmedia\u002Ftips\u002F2026\u002Fline-launch-issue_landingpage-ja.png",[26,39,40],{},"また、LINEミニアプリ開発者のみなさんも「Facebookからミニアプリが開けない」という相談を受けたことはないでしょうか。",[26,42,43],{},"FacebookやInstagram、XなどのSNSアプリに組み込まれたアプリ内ブラウザでは、この挙動が起きやすい傾向にあります。一見するとLINEミニアプリやLINEの不具合に見えますが、実際にはOSやブラウザ、WebViewの仕様が影響しているケースが少なくありません。",[26,45,46],{},"この記事では、こうした現象が起きる背景と、LINEミニアプリ開発者が現実的にできる案内方法を整理します。",[48,49],"toc",{},[51,52,54],"h2",{"id":53},"why-it-happens","なぜ起きるのか",[26,56,57],{},"WebページからLINEを開く仕組みにはいくつかの種類があります。",[26,59,60,61,66,67,71,72,76,77,80,81,84],{},"一般に",[62,63,65],"a",{"href":64},"\u002Fdocs\u002Fliff\u002Fopening-liff-app\u002F","LIFF URLを開いたときの動作","や、",[62,68,70],{"href":69},"\u002Fdocs\u002Fline-login\u002Fintegrate-line-login\u002F#line-auto-login","LINEログインの自動ログイン","のように、WebページからLINEを開く処理においては",[73,74,75],"strong",{},"ユニバーサルリンク","や",[73,78,79],{},"アプリリンク","が利用されます。一方で、ランディングページの「LINEで開く」ボタンのように、",[73,82,83],{},"カスタムURLスキーム","が利用されているケースもあります。",[26,86,87],{},"いずれの場合も、実際にLINEが起動するかどうかは、ユーザーが利用しているOS、ブラウザ、アプリ内ブラウザの挙動に大きく左右されます。そのため、ページ側の設定に問題がなくても、環境によっては期待どおりにLINEが起動しないことがあります。",[26,89,90],{},"結果としてLINEを起動するためのリンクやボタンが適切に設置されていても、LINEアプリが起動せず、そのままブラウザ上でログイン画面が表示されたり、時には画面が全く変化しない場合もあります。",[51,92,94],{"id":93},"why-line-opens","そもそもどうして「LINEが開く」のか",[26,96,97,98,100,101,103],{},"その背景にあるのが「URLをタップしたときに、対応するアプリが入っていればそのアプリを開く」という仕組みです。代表的なのが、iOSの",[73,99,75],{},"とAndroidの",[73,102,79],{},"です。",[26,105,106,107,113],{},"iOSのユニバーサルリンクでは、ウェブサイトとアプリが関連付けられていると、対応するURLをタップした際にSafariを経由せずアプリを開きます。アプリが入っていない場合は、そのままウェブページがブラウザで開きます。詳細はApple公式ドキュメントの",[62,108,112],{"href":109,"rel":110},"https:\u002F\u002Fdeveloper.apple.com\u002Fdocumentation\u002Fxcode\u002Fsupporting-universal-links-in-your-app",[111],"nofollow","Universal Links","を参照してください。",[26,115,116,117,113],{},"Androidのアプリリンクも考え方はほぼ同じですが、こちらはウェブサイトとアプリの関連付けを検証したうえで、対応するURLをアプリで開きます。検証に成功したアプリリンクは、通常、アプリ選択ダイアログを表示せずにそのままアプリを開きます。詳細はAndroid Developersの",[62,118,121],{"href":119,"rel":120},"https:\u002F\u002Fdeveloper.android.com\u002Ftraining\u002Fapp-links",[111],"App Links",[26,123,124],{},"開発者目線では、「LINE専用の特別なURLだから開く」というよりも、「通常のURLをOSが見て、対応するアプリを開くかどうかを判断している」と捉えるとわかりやすいでしょう。",[126,127,130],"admonition",{"title":128,"type":129},"カスタムURLスキームについて","note",[26,131,132,133,137,138,142],{},"LINEミニアプリのランディングページなどで利用されている「LINEで開く」ボタンは、カスタムURLスキームを利用しています。これはユニバーサルリンクやアプリリンクよりも古い仕組みで、URLの形式が",[134,135,136],"code",{},"line:\u002F\u002F","のように特定のスキームを持つものですが、特定の条件を満たした場合に「乗っ取り攻撃」のリスクがあるため、一般にはユニバーサルリンクやアプリリンクの利用が推奨されています。\n詳細については「",[62,139,141],{"href":140},"\u002Fdocs\u002Fline-login\u002Fusing-line-url-scheme\u002F","LINE URLスキームでLINEの機能を使う","」を参照してください。",[144,145,147],"h3",{"id":146},"universal-link-on-ios","iOSで知っておきたいこと",[26,149,150],{},"iOSのユニバーサルリンクは便利ですが、常に無条件でアプリが開くわけではありません。たとえば、Safariで閲覧中のページと同じドメイン名のリンクをタップした場合は、ユニバーサルリンクの設定が適切であってもOSの判断によりSafariでページを開き続けることがあります。",[26,152,153],{},"また、URLをブラウザのアドレスバーに直接入力した場合は、ユニバーサルリンクとして扱われず、アプリは開きません。そのため、同じURLでも「リンクをタップした」のか「アドレスバーに入力した」のかで挙動が変わります。ミニアプリのURLを直接アドレスバーに入力してアクセスするユーザーは少ないと考えられますが、知識として知っておくとアプリのテスト時に役に立つかもしれません。",[144,155,157],{"id":156},"app-links-on-android","Androidで知っておきたいこと",[26,159,160],{},"Androidでは、通常のディープリンクと、検証済みのアプリリンクを区別して考える必要があります。",[26,162,163],{},"通常のディープリンクは、条件によってはブラウザやアプリ選択ダイアログが表示されます。一方で、検証済みのアプリリンクは、ウェブサイトの所有者とアプリの対応関係が確認できているため、対応URLをより直接的にアプリへルーティングできます。",[26,165,166],{},"特にAndroid 12以降では、アプリがそのドメインでの検証に成功しない限り、一般的なウェブリンクはアプリではなくブラウザで開かれます。LINEをご利用のみなさんが遭遇することはめったにありませんが、古いバージョンのAndroid OSを利用している場合にこのような挙動が起きうることは、開発者のみなさんは知っておくとよいでしょう。",[126,168,171],{"title":169,"type":170},"Androidでは端末固有の事情が影響することもあります","tip",[26,172,173],{},"Androidでは、OSのバージョンだけでなく、端末メーカー独自のブラウザ実装やセキュリティ機能がURLの処理に関与することがあります。たとえばSamsungやOPPOのスマートフォンでは、メーカー独自のブラウザやセキュリティアプリ等がURLハンドリングに影響を与えることが知られており、条件が揃った場合にLINEが想定どおりに開かない可能性があります。\nこのように、Androidでは端末メーカー独自の実装によっても、LINEを開く際の挙動が変化しうることに注意しましょう。",[51,175,177],{"id":176},"in-app-browser","特にアプリ内ブラウザでは起きやすい",[26,179,180],{},"Facebook、Instagram、Xなどのアプリ内ブラウザでは、LINEを起動するための仕組みが通常のブラウザほど安定して動作しないことがあります。実際に「LINEで開く」や「LINEでログイン」を実行してもLINEアプリが起動しない、といった報告は多く寄せられています。",[26,182,183],{},"このような挙動は、各アプリのWebView実装やアプリ側の仕様に依存する問題であるため、各アプリベンダー（Meta社やX社など）の対応に左右されます。すなわち、LINEアプリ側では予防することができない問題です。",[126,185,187],{"title":186,"type":170},"アプリ内ブラウザは遷移を自由に制御できます",[26,188,189,190,193],{},"一般的にモバイルアプリのアプリ内ブラウザでは、開こうとしたURLに対して、アプリ側がその遷移を許可するかどうかを制御できます。\nたとえばiOSでは、",[134,191,192],{},"webView(_:decidePolicyFor:decisionHandler:)"," のような仕組みを応用すれば「LINEを起動するためのURLだけをブロックする」といったこともできます。\n実際にSNSアプリがそのような実装をしているかどうかはわかりませんが、アプリ内ブラウザの挙動はアプリベンダー側でコントロールできることは知っておくとよいでしょう。",[26,195,196],{},"一方で、同じページをSafari（iOS）やChrome（Android）などの外部ブラウザで開き直すと、正常に「LINEで開く」や「LINEでログイン」を実行できることがよくあります。",[126,198,200],{"title":199,"type":170},"挙動はアプリやバージョンによって変わります",[26,201,202],{},"SNSアプリに限らず、各アプリ内ブラウザの挙動は、該当のアプリのバージョンやOSの更新によって変わることがあります。あるアプリで常に再現するとは限らず、逆に以前は問題なかった環境で動かなくなることもあります。",[51,204,206],{"id":205},"what-developers-can-do","開発者ができることは多くありません",[26,208,209],{},"上記のように、問題の原因がOSやアプリベンダー側の仕様にある場合、LIFFやLINEログインを利用する開発者ができる対策は限られます。LINEアプリを確実に起動させる方法を、ミニアプリ側だけで完全にコントロールすることは困難です。",[26,211,212],{},"そのため、現実的には以下のような対応を検討することになります。",[214,215,216,220,223],"ul",{},[217,218,219],"li",{},"LINEが起動しない場合は、Safari（iOS）やChrome（Android）などの外部ブラウザでページを開いて再度試すよう案内する",[217,221,222],{},"外部ブラウザでもサービスを利用できる場合は、LINE起動に失敗してもそのまま利用を継続できる導線を用意する",[217,224,225],{},"iOSではLIFF URLへのアクセス時に、JavaScriptによる自動リダイレクトではなく、ユーザーのタップでログイン処理を開始する",[26,227,228],{},"たとえば、ユーザーへの案内としては、次のような短いメッセージが考えられます。",[230,231,232],"blockquote",{},[26,233,234],{},"LINEが起動しない場合は、Safari（iOS）またはChrome（Android）でこのページを開いて、もう一度お試しください。",[26,236,237,238,242],{},"LINEミニアプリやLIFFアプリを提供している場合は、『LINEミニアプリドキュメント』の「",[62,239,241],{"href":240},"\u002Fdocs\u002Fline-mini-app\u002Fdevelop\u002Fexternal-browser\u002F","外部ブラウザでLINEミニアプリを開く","」もあわせて参照してください。",[51,244,246],{"id":245},"ios-safari","iOSではSafariでも起きることがある",[26,248,249,250,253],{},"iOSでは、たとえSafariであっても",[62,251,70],{"href":252},"\u002Fdocs\u002Fline-login\u002Fhow-to-handle-auto-login-failure\u002F","時にユニバーサルリンク経由でLINEを開こうとした際に、まれに自動で起動できないことがあります。",[26,255,256],{},"たとえば、LINEを起動するときに「このページをLINEで開きますか」という確認ダイアログが表示されることがありますが、こうした確認で何度か「キャンセル」を選ぶと、その後はLINEが自動で開きにくくなったように感じることがあります。",[126,258,260],{"title":259,"type":129},"Appleが正式に発表している仕様ではありません",[26,261,262],{},"この挙動はAppleが公式に詳しく説明しているものではなく、ユーザーからの報告をベースに経験的に知られているものです。現時点では、OSがユーザーの選択傾向を考慮して挙動を変えている可能性はあるものの、そのような仕様が開示されているわけではないため、断定は避けるのが適切でしょう。",[26,264,265,266,269],{},"このような場合は、画面の下にある「LINEアプリでログイン」を長押しし、表示されたコンテキストメニューから［",[73,267,268],{},"LINEで開く","］を選ぶと、正常に起動することがあります。",[271,272,273,290],"table",{},[274,275,276],"thead",{},[277,278,279,284,287],"tr",{},[280,281,283],"th",{"align":282},"center","1",[280,285,286],{"align":282},"2",[280,288,289],{"align":282},"3",[291,292,293],"tbody",{},[277,294,295,302,308],{},[296,297,298],"td",{"align":282},[32,299],{"alt":15,"className":300,"src":301},[35,36],"\u002Fmedia\u002Ftips\u002F2026\u002Fline-login-failed-ja.png",[296,303,304],{"align":282},[32,305],{"alt":15,"className":306,"src":307},[35,36],"\u002Fmedia\u002Ftips\u002F2026\u002Fline-login-failed-retry-1-ja.png",[296,309,310],{"align":282},[32,311],{"alt":15,"className":312,"src":313},[35,36],"\u002Fmedia\u002Ftips\u002F2026\u002Fline-login-failed-retry-2-ja.png",[26,315,316],{},"何らかの理由でログイン画面を経由したログインが必要なケースでは、この挙動を知っておくと、ユーザーサポートの際に役立つかもしれません。",[51,318,320],{"id":319},"wrap-up","おわりに",[26,322,323],{},"「LINEで開く」や「LINEでログイン」がうまく動かないときでも、LINEミニアプリの実装やLINEログインの組み込み、あるいは起動用リンクやボタンの設置に不備があるとは限りません。原因は、OSやアプリ内ブラウザの仕様にあることがあります。",[26,325,326],{},"こうしたケースにおいて、開発者としては「必ず起動させる方法」を探すよりも、起動しない環境があることを前提に、ユーザーへの案内や代替導線を用意することが重要です。",[26,328,329],{},"特に、外部サービスやSNSアプリからの流入が多い導線では、SafariやChromeで開き直す案内を事前に用意しておくと、問い合わせ対応もスムーズになるでしょう。",[331,332],"tags",{"tags":333,"lang":334,"section":335},"line-login, liff","en","tips",{"title":15,"searchDepth":337,"depth":337,"links":338},4,[339,343,354,357,360,363],{"id":340,"depth":341,"text":342},"なぜ起きるのか-why-it-happens",2,"なぜ起きるのか {#why-it-happens}",{"id":344,"depth":341,"text":345,"children":346},"そもそもどうしてlineが開くのか-why-line-opens","そもそもどうして「LINEが開く」のか {#why-line-opens}",[347,351],{"id":348,"depth":349,"text":350},"iosで知っておきたいこと-universal-link-on-ios",3,"iOSで知っておきたいこと {#universal-link-on-ios}",{"id":352,"depth":349,"text":353},"androidで知っておきたいこと-app-links-on-android","Androidで知っておきたいこと {#app-links-on-android}",{"id":355,"depth":341,"text":356},"特にアプリ内ブラウザでは起きやすい-in-app-browser","特にアプリ内ブラウザでは起きやすい {#in-app-browser}",{"id":358,"depth":341,"text":359},"開発者ができることは多くありません-what-developers-can-do","開発者ができることは多くありません {#what-developers-can-do}",{"id":361,"depth":341,"text":362},"iosではsafariでも起きることがある-ios-safari","iOSではSafariでも起きることがある {#ios-safari}",{"id":364,"depth":341,"text":365},"おわりに-wrap-up","おわりに {#wrap-up}","md",{"date":368,"tags":333,"locale":369,"sidebar":370},"2026-05-07 00:00 UTC","ja",false,true,"\u002Fja\u002Ftips\u002F2026\u002F05\u002F07\u002Fline-launch-issue",{"title":5,"description":28},"ja\u002Ftips\u002F2026\u002F05\u002F07\u002Fline-launch-issue","YUkWzRRhwsHjA0vjUjpxIWoSKxCSetLcy7AhoZIUMlY",{"id":4,"title":5,"body":377,"description":28,"extension":366,"meta":580,"navigation":371,"path":372,"seo":581,"stem":374,"__hash__":375},{"type":7,"value":378,"toc":569},[379],[10,380,381,385,387,389,394,396,398,400,402,404,406,418,420,422,424,430,435,440,442,450,452,454,456,458,460,462,464,468,470,472,474,480,482,486,488,490,492,500,502,506,510,512,516,518,522,526,557,559,561,563,565,567],{},[13,382,383],{"id":15,"class":16},[18,384],{},[21,386],{"date":23,"class":24},[26,388,28],{},[26,390,391],{},[32,392],{"alt":15,"className":393,"src":37},[35,36],[26,395,40],{},[26,397,43],{},[26,399,46],{},[48,401],{},[51,403,54],{"id":53},[26,405,57],{},[26,407,60,408,66,410,71,412,76,414,80,416,84],{},[62,409,65],{"href":64},[62,411,70],{"href":69},[73,413,75],{},[73,415,79],{},[73,417,83],{},[26,419,87],{},[26,421,90],{},[51,423,94],{"id":93},[26,425,97,426,100,428,103],{},[73,427,75],{},[73,429,79],{},[26,431,106,432,113],{},[62,433,112],{"href":109,"rel":434},[111],[26,436,116,437,113],{},[62,438,121],{"href":119,"rel":439},[111],[26,441,124],{},[126,443,444],{"title":128,"type":129},[26,445,132,446,137,448,142],{},[134,447,136],{},[62,449,141],{"href":140},[144,451,147],{"id":146},[26,453,150],{},[26,455,153],{},[144,457,157],{"id":156},[26,459,160],{},[26,461,163],{},[26,463,166],{},[126,465,466],{"title":169,"type":170},[26,467,173],{},[51,469,177],{"id":176},[26,471,180],{},[26,473,183],{},[126,475,476],{"title":186,"type":170},[26,477,189,478,193],{},[134,479,192],{},[26,481,196],{},[126,483,484],{"title":199,"type":170},[26,485,202],{},[51,487,206],{"id":205},[26,489,209],{},[26,491,212],{},[214,493,494,496,498],{},[217,495,219],{},[217,497,222],{},[217,499,225],{},[26,501,228],{},[230,503,504],{},[26,505,234],{},[26,507,237,508,242],{},[62,509,241],{"href":240},[51,511,246],{"id":245},[26,513,249,514,253],{},[62,515,70],{"href":252},[26,517,256],{},[126,519,520],{"title":259,"type":129},[26,521,262],{},[26,523,265,524,269],{},[73,525,268],{},[271,527,528,538],{},[274,529,530],{},[277,531,532,534,536],{},[280,533,283],{"align":282},[280,535,286],{"align":282},[280,537,289],{"align":282},[291,539,540],{},[277,541,542,547,552],{},[296,543,544],{"align":282},[32,545],{"alt":15,"className":546,"src":301},[35,36],[296,548,549],{"align":282},[32,550],{"alt":15,"className":551,"src":307},[35,36],[296,553,554],{"align":282},[32,555],{"alt":15,"className":556,"src":313},[35,36],[26,558,316],{},[51,560,320],{"id":319},[26,562,323],{},[26,564,326],{},[26,566,329],{},[331,568],{"tags":333,"lang":334,"section":335},{"title":15,"searchDepth":337,"depth":337,"links":570},[571,572,576,577,578,579],{"id":340,"depth":341,"text":342},{"id":344,"depth":341,"text":345,"children":573},[574,575],{"id":348,"depth":349,"text":350},{"id":352,"depth":349,"text":353},{"id":355,"depth":341,"text":356},{"id":358,"depth":341,"text":359},{"id":361,"depth":341,"text":362},{"id":364,"depth":341,"text":365},{"date":368,"tags":333,"locale":369,"sidebar":370},{"title":5,"description":28},[583,584,588,589,590,591],{"id":53,"depth":341,"text":54},{"id":93,"depth":341,"text":94,"children":585},[586,587],{"id":146,"depth":349,"text":147},{"id":156,"depth":349,"text":157},{"id":176,"depth":341,"text":177},{"id":205,"depth":341,"text":206},{"id":245,"depth":341,"text":246},{"id":319,"depth":341,"text":320},1778735715709]