基于Android 错误信息捕获发送至服务器的详解

程序员最头疼的事情就是bug和debug。这次debug长达20天，搞的我心力交瘁。累，因为Android兼容性，不同手机会有不同的bug出来，而且很难复现，所以就上网找了下类似保存错误log到文件再上传到服务器，现把源码也共享出来。上传至服务器的代码我没加。相信大家都有现成的代码了。

先讲下原理，跟JavaEE的自定义异常捕获一样，将错误一直向上抛，然后在最上层统一处理。这里就可以获得Exception Message，进行保存操作
异常捕获类如下：


代码如下:

/**
 * @author Stay
 *      在Application中统一捕获异常，保存到文件中下次再打开时上传
 */
public class CrashHandler implements UncaughtExceptionHandler {  
    /** 是否开启日志输出,在Debug状态下开启, 
     * 在Release状态下关闭以提示程序性能 
     * */ 
    public static final boolean DEBUG = true;  
    /** 系统默认的UncaughtException处理类 */ 
    private Thread.UncaughtExceptionHandler mDefaultHandler;  
    /** CrashHandler实例 */ 
    private static CrashHandler INSTANCE;  
    /** 程序的Context对象 */ 
//    private Context mContext;  
    /** 保证只有一个CrashHandler实例 */ 
    private CrashHandler() {}  
    /** 获取CrashHandler实例 ,单例模式*/ 
    public static CrashHandler getInstance() {  
        if (INSTANCE == null) {  
            INSTANCE = new CrashHandler();  
        }  
        return INSTANCE;  
    }

/** 
     * 初始化,注册Context对象, 
     * 获取系统默认的UncaughtException处理器, 
     * 设置该CrashHandler为程序的默认处理器 
     *  
     * @param ctx 
     */ 
    public void init(Context ctx) {  
//        mContext = ctx;  
        mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();  
        Thread.setDefaultUncaughtExceptionHandler(this);  
    }

/** 
     * 当UncaughtException发生时会转入该函数来处理 
     */ 
    @Override 
    public void uncaughtException(Thread thread, Throwable ex) {  
        if (!handleException(ex) && mDefaultHandler != null) {  
            //如果用户没有处理则让系统默认的异常处理器来处理  
            mDefaultHandler.uncaughtException(thread, ex);  
        } else {  //如果自己处理了异常，则不会弹出错误对话框，则需要手动退出app
            try {  
                Thread.sleep(3000);  
            } catch (InterruptedException e) {  
            }  
            android.os.Process.killProcess(android.os.Process.myPid());  
            System.exit(10);  
        }  
    }

/** 
     * 自定义错误处理,收集错误信息 
     * 发送错误报告等操作均在此完成. 
     * 开发者可以根据自己的情况来自定义异常处理逻辑 
     * @return 
     * true代表处理该异常，不再向上抛异常，
     * false代表不处理该异常(可以将该log信息存储起来)然后交给上层(这里就到了系统的异常处理)去处理，
     * 简单来说就是true不会弹出那个错误提示框，false就会弹出
     */ 
    private boolean handleException(final Throwable ex) {  
        if (ex == null) {  
            return false;  
        }  
//        final String msg = ex.getLocalizedMessage();  
        final StackTraceElement[] stack = ex.getStackTrace();
        final String message = ex.getMessage();
        //使用Toast来显示异常信息  
        new Thread() {  
            @Override 
            public void run() {  
                Looper.prepare();  
//                Toast.makeText(mContext, "程序出错啦:" + message, Toast.LENGTH_LONG).show();  
//                可以只创建一个文件，以后全部往里面append然后发送，这样就会有重复的信息，个人不推荐
                String fileName = "crash-" + System.currentTimeMillis()  + ".log";  
                File file = new File(Environment.getExternalStorageDirectory(), fileName);
                try {
                    FileOutputStream fos = new FileOutputStream(file,true);
                    fos.write(message.getBytes());
                    for (int i = 0; i < stack.length; i++) {
                        fos.write(stack[i].toString().getBytes());
                    }
                    fos.flush();
                    fos.close();
                } catch (Exception e) {
                }
                Looper.loop();  
            }

}.start();  
        return false;  
    }

// TODO 使用HTTP Post 发送错误报告到服务器  这里不再赘述
//    private void postReport(File file) {  
//      在上传的时候还可以将该app的version，该手机的机型等信息一并发送的服务器，
//      Android的兼容性众所周知，所以可能错误不是每个手机都会报错，还是有针对性的去debug比较好
//    }  
}

在Application onCreate时就注册ExceptionHandler，此后只要程序在抛异常后就能捕获到。


代码如下:

public class App extends Application{
        @Override 
        public void onCreate() {  
            super.onCreate();  
            CrashHandler crashHandler = CrashHandler.getInstance();  
            //注册crashHandler  
            crashHandler.init(getApplicationContext());  
        }  
}
?public class LogActivity extends Activity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        try {//制造bug
            File file = new File(Environment.getExternalStorageState() ,"crash.bin");
            FileInputStream fis = new FileInputStream(file);
            byte[] buffer = new byte[1024];
            fis.read(buffer);
        } catch (Exception e) {
            //这里不能再向上抛异常，如果想要将log信息保存起来，则抛出runtime异常，
//          让自定义的handler来捕获，统一将文件保存起来上传
            throw new RuntimeException(e);
        }
    }
}

注意，如果catch后不throw就默认是自己处理了，ExceptionHandler不会捕获异常了。
再分享一个Log的封装类，只要在这里设置DEBUG的值就能让控制台是否打印出log


代码如下:

public class DebugUtil {
    public static final String TAG = "ICON";
    public static final boolean DEBUG = true;

public static void toast(Context context,String content){
        Toast.makeText(context, content, Toast.LENGTH_SHORT).show();
    }

public static void debug(String tag,String msg){
        if (DEBUG) {
            Log.d(tag, msg);
        }
    }

public static void debug(String msg){
        if (DEBUG) {
            Log.d(TAG, msg);
        }
    }

public static void error(String tag,String error){
        Log.e(tag, error);
    }

public static void error(String error){
        Log.e(TAG, error);
    }
}