java - How can I fix 'android.os.NetworkOnMainThreadException'?

ID : 273

viewed : 317

Tags : javaandroidandroid-networkingnetworkonmainthreadjava

Top 5 Answer for java - How can I fix 'android.os.NetworkOnMainThreadException'?

vote vote


NOTE : AsyncTask was deprecated in API level 30.
AsyncTask | Android Developers

This exception is thrown when an application attempts to perform a networking operation on its main thread. Run your code in AsyncTask:

class RetrieveFeedTask extends AsyncTask<String, Void, RSSFeed> {      private Exception exception;      protected RSSFeed doInBackground(String... urls) {         try {             URL url = new URL(urls[0]);             SAXParserFactory factory = SAXParserFactory.newInstance();             SAXParser parser = factory.newSAXParser();             XMLReader xmlreader = parser.getXMLReader();             RssHandler theRSSHandler = new RssHandler();             xmlreader.setContentHandler(theRSSHandler);             InputSource is = new InputSource(url.openStream());             xmlreader.parse(is);              return theRSSHandler.getFeed();         } catch (Exception e) {             this.exception = e;              return null;         } finally {             is.close();         }     }      protected void onPostExecute(RSSFeed feed) {         // TODO: check this.exception         // TODO: do something with the feed     } } 

How to execute the task:

In file you can add this line within your oncreate() method

new RetrieveFeedTask().execute(urlToRssFeed); 

Don't forget to add this to AndroidManifest.xml file:

<uses-permission android:name="android.permission.INTERNET"/> 
vote vote


You should almost always run network operations on a thread or as an asynchronous task.

But it is possible to remove this restriction and you override the default behavior, if you are willing to accept the consequences.


StrictMode.ThreadPolicy policy = new StrictMode.ThreadPolicy.Builder().permitAll().build();  StrictMode.setThreadPolicy(policy); 

In your class,


Add this permission in the Android manifest.xml file:

<uses-permission android:name="android.permission.INTERNET"/> 


Your app will (in areas of spotty Internet connection) become unresponsive and lock up, the user perceives slowness and has to do a force kill, and you risk the activity manager killing your app and telling the user that the app has stopped.

Android has some good tips on good programming practices to design for responsiveness: NetworkOnMainThreadException | Android Developers

vote vote


I solved this problem using a new Thread.

Thread thread = new Thread(new Runnable() {      @Override     public void run() {         try  {             //Your code goes here         } catch (Exception e) {             e.printStackTrace();         }     } });  thread.start();  
vote vote


The accepted answer has some significant downsides. It is not advisable to use AsyncTask for networking unless you really know what you are doing. Some of the down-sides include:

  • AsyncTask's created as non-static inner classes have an implicit reference to the enclosing Activity object, its context, and the entire View hierarchy created by that activity. This reference prevents the Activity from being garbage collected until the AsyncTask's background work completes. If the user's connection is slow, and/or the download is large, these short-term memory leaks can become a problem - for example, if the orientation changes several times (and you don't cancel the executing tasks), or the user navigates away from the Activity.
  • AsyncTask has different execution characteristics depending on the platform it executes on: prior to API level 4 AsyncTasks execute serially on a single background thread; from API level 4 through API level 10, AsyncTasks execute on a pool of up to 128 threads; from API level 11 onwards AsyncTask executes serially on a single background thread (unless you use the overloaded executeOnExecutor method and supply an alternative executor). Code that works fine when running serially on ICS may break when executed concurrently on Gingerbread, say if you have inadvertent order-of-execution dependencies.

If you want to avoid short-term memory leaks, have well-defined execution characteristics across all platforms, and have a base to build really robust network handling, you might want to consider:

  1. Using a library that does a nice job of this for you - there's a nice comparison of networking libs in this question, or
  2. Using a Service or IntentService instead, perhaps with a PendingIntent to return the result via the Activity's onActivityResult method.

IntentService approach


  • More code and complexity than AsyncTask, though not as much as you might think
  • Will queue requests and run them on a single background thread. You can easily control this by replacing IntentService with an equivalent Service implementation, perhaps like this one.
  • Um, I can't think of any others right now actually


  • Avoids the short-term memory leak problem
  • If your activity restarts while network operations are in-flight it can still receive the result of the download via its onActivityResult method
  • A better platform than AsyncTask to build and reuse robust networking code. Example: if you need to do an important upload, you could do it from AsyncTask in an Activity, but if the user context-switches out of the app to take a phone call, the system may kill the app before the upload completes. It is less likely to kill an application with an active Service.
  • If you use your own concurrent version of IntentService (like the one I linked above) you can control the level of concurrency via the Executor.

Implementation summary

You can implement an IntentService to perform downloads on a single background thread quite easily.

Step 1: Create an IntentService to perform the download. You can tell it what to download via Intent extras, and pass it a PendingIntent to use to return the result to the Activity:

import; import; import android.content.Intent; import android.util.Log;  import; import; import;  public class DownloadIntentService extends IntentService {      private static final String TAG = DownloadIntentService.class.getSimpleName();      public static final String PENDING_RESULT_EXTRA = "pending_result";     public static final String URL_EXTRA = "url";     public static final String RSS_RESULT_EXTRA = "url";      public static final int RESULT_CODE = 0;     public static final int INVALID_URL_CODE = 1;     public static final int ERROR_CODE = 2;      private IllustrativeRSSParser parser;      public DownloadIntentService() {         super(TAG);          // make one and reuse, in the case where more than one intent is queued         parser = new IllustrativeRSSParser();     }      @Override     protected void onHandleIntent(Intent intent) {         PendingIntent reply = intent.getParcelableExtra(PENDING_RESULT_EXTRA);         InputStream in = null;         try {             try {                 URL url = new URL(intent.getStringExtra(URL_EXTRA));                 IllustrativeRSS rss = parser.parse(in = url.openStream());                  Intent result = new Intent();                 result.putExtra(RSS_RESULT_EXTRA, rss);                  reply.send(this, RESULT_CODE, result);             } catch (MalformedURLException exc) {                 reply.send(INVALID_URL_CODE);             } catch (Exception exc) {                 // could do better by treating the different sax/xml exceptions individually                 reply.send(ERROR_CODE);             }         } catch (PendingIntent.CanceledException exc) {             Log.i(TAG, "reply cancelled", exc);         }     } } 

Step 2: Register the service in the manifest:

<service         android:name=".DownloadIntentService"         android:exported="false"/> 

Step 3: Invoke the service from the Activity, passing a PendingResult object which the Service will use to return the result:

PendingIntent pendingResult = createPendingResult(     RSS_DOWNLOAD_REQUEST_CODE, new Intent(), 0); Intent intent = new Intent(getApplicationContext(), DownloadIntentService.class); intent.putExtra(DownloadIntentService.URL_EXTRA, URL); intent.putExtra(DownloadIntentService.PENDING_RESULT_EXTRA, pendingResult); startService(intent); 

Step 4: Handle the result in onActivityResult:

@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) {     if (requestCode == RSS_DOWNLOAD_REQUEST_CODE) {         switch (resultCode) {             case DownloadIntentService.INVALID_URL_CODE:                 handleInvalidURL();                 break;             case DownloadIntentService.ERROR_CODE:                 handleError(data);                 break;             case DownloadIntentService.RESULT_CODE:                 handleRSS(data);                 break;         }         handleRSS(data);     }     super.onActivityResult(requestCode, resultCode, data); } 

A GitHub project containing a complete working Android Studio/Gradle project is available here.

vote vote


You cannot perform network I/O on the UI thread on Honeycomb. Technically, it is possible on earlier versions of Android, but it is a really bad idea as it will cause your app to stop responding, and can result in the OS killing your app for being badly behaved. You'll need to run a background process or use AsyncTask to perform your network transaction on a background thread.

There is an article about Painless Threading on the Android developer site which is a good introduction to this, and it will provide you with a much better depth of an answer than can be realistically provided here.

Top 3 video Explaining java - How can I fix 'android.os.NetworkOnMainThreadException'?