android.os.NetworkOnMainThreadExceptionの原因と解決方法を徹底解説

NetworkOnMainThreadExceptionとは？

android.os.NetworkOnMainThreadExceptionは、アプリケーションがメインスレッド（UIスレッド）上でネットワーク操作を実行しようとした際にスローされる例外です。

この例外は、Honeycomb（Android 3.0／APIレベル11）以降をターゲットとするアプリでのみ発生します。それ以前のSDKバージョンをターゲットとしたアプリでは、メインスレッドでのネットワーク処理が許可されていますが、UIの応答性を損なうため強く非推奨とされています。

本記事では、実際のサンプルプログラムを通じて、この例外を回避する具体的な方法をステップごとに解説します。

解決のポイント：バックグラウンドスレッドで通信を行う

解決策の基本は、ネットワーク処理をAsyncTaskなどの仕組みを使ってバックグラウンドスレッドで実行することです。以下のサンプルでは、指定したURLからテキストデータを取得し、画面に表示する処理をAsyncTaskで実装しています。

ステップ1：新規プロジェクトの作成

Android Studioで新しいプロジェクトを作成します。メニューから「File」→「New Project」を選択し、必要な項目を入力してプロジェクトを作成してください。

ステップ2：レイアウトファイル（activity_main.xml）の編集

res/layout/activity_main.xmlに以下のコードを記述します。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:gravity="center"
    android:padding="8dp"
    tools:context=".MainActivity">
    <TextView
        android:id="@+id/textLoad"
        android:textSize="12sp"
        android:textStyle="bold|italic"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
    <TextView
        android:id="@+id/textMessage"
        android:textSize="16sp"
        android:textStyle="bold"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>
</LinearLayout>

ステップ3：MainActivity.javaの編集

src/MainActivity.javaに以下のコードを記述します。ポイントは、ネットワーク処理をdoInBackground()内（バックグラウンドスレッド）で行い、結果の表示はonPostExecute()（UIスレッド）で行っている点です。

import androidx.appcompat.app.AppCompatActivity;
import android.os.AsyncTask;
import android.os.Bundle;
import android.widget.TextView;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.URL;
public class MainActivity extends AppCompatActivity {
    TextView textLoad, textMessage;
    final String strMessage = "https://sites.google.com/site/androidersite/text.txt";
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textLoad = findViewById(R.id.textLoad);
        textMessage = findViewById(R.id.textMessage);
        textLoad.setText("Loading...");
        new MyTask().execute();
    }
    private class MyTask extends AsyncTask<Void, Void, Void>{
        String result;
        @Override
        protected Void doInBackground(Void... voids) {
            URL url;
            try {
                url = new URL(strMessage);
                BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(url.openStream()));
                String stringBuffer;
                String string = "";
                while ((stringBuffer = bufferedReader.readLine()) != null){
                    string = String.format("%s%s", string, stringBuffer);
                }
                bufferedReader.close();
                result = string;
            } catch (IOException e){
                e.printStackTrace();
                result = e.toString();
            }
            return null;
        }
        @Override
        protected void onPostExecute(Void aVoid) {
            textMessage.setText(result);
            textLoad.setText("Finished");
            super.onPostExecute(aVoid);
        }
    }
}

ステップ4：AndroidManifest.xmlの編集

androidManifest.xmlに以下のコードを記述します。インターネット通信を行うため、<uses-permission>によるINTERNET権限の宣言が必須である点に注意してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <uses-permission android:name="android.permission.INTERNET"/>
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それでは、アプリケーションを実行してみましょう。ここでは、実際のAndroid端末をパソコンに接続しているものとして説明します。Android Studioからアプリを実行するには、プロジェクト内のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。表示された選択肢から接続済みのモバイルデバイスを選択すると、端末の画面にローディング表示の後に取得したテキストが表示されます。

補足：AsyncTask以外の現代的な代替手段

なお、AsyncTaskはAPIレベル30で非推奨（Deprecated）となっています。現在のAndroid開発では、Kotlinコルーチン、ExecutorService、RxJava、WorkManagerなどを利用してバックグラウンド処理やネットワーク通信を行うことが推奨されています。どの手法を選ぶ場合でも、「メインスレッドでネットワーク処理を行わない」という原則自体は変わらないため、本記事の考え方はそのまま活かせます。