NetworkOnMainThreadException이란 무엇인가?
android.os.NetworkOnMainThreadException은 애플리케이션이 메인 스레드(UI 스레드)에서 네트워크 작업을 수행하려고 할 때 발생하는 예외입니다.
이 예외는 Honeycomb SDK(API 레벨 11) 이상을 타겟으로 하는 애플리케이션에서만 발생합니다. 그 이전 SDK 버전을 타겟으로 하는 앱은 메인 이벤트 루프 스레드에서 네트워킹이 허용되지만, 이는 강력히 권장되지 않습니다.
메인 스레드에서 네트워크 통신을 수행하면 화면이 멈추거나 ANR(Application Not Responding) 오류가 발생해 사용자 경험이 크게 저하됩니다. 따라서 네트워크 작업은 반드시 백그라운드 스레드에서 처리해야 합니다. 아래 예제를 통해 이 예외를 해결하는 방법을 단계별로 살펴보겠습니다.
이 예제는 AsyncTask를 활용해 android.os.NetworkOnMainThreadException을 수정하는 방법을 보여줍니다.
1단계 — 새 프로젝트 생성
Android Studio에서 File ⇒ New Project로 이동한 후, 필요한 정보를 모두 입력하여 새 프로젝트를 생성합니다.
2단계 — 레이아웃 파일 작성
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에 다음 코드를 추가합니다. 핵심은 네트워크 요청을 AsyncTask의 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에 인터넷 권한을 포함한 다음 코드를 추가합니다.
<?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 Studio에서 앱을 실행하려면 프로젝트의 액티비티 파일 중 하나를 열고 툴바에서 실행(Run) 아이콘을 클릭합니다. 목록에서 자신의 모바일 기기를 선택한 후, 기기에 기본 화면이 정상적으로 표시되는지 확인합니다.
참고: 최신 대안 기술
AsyncTask는 현재 공식적으로 지원 중단(deprecated)된 API입니다. 신규 프로젝트에서는 Kotlin 코루틴(Coroutines), ExecutorService, Retrofit + OkHttp, RxJava 같은 현대적인 비동기 처리 방식을 사용하는 것이 좋습니다. 어떤 방식을 선택하든, 네트워크 작업을 메인 스레드가 아닌 별도의 워커 스레드에서 처리한다는 원칙만 지키면 이 예외를 피할 수 있습니다.