A bachelor's degree still pays off, at least on average and in the long run. Yet there’s growing recognition that not all degrees lead to a good salary.