断藤峡原名为大藤峡，位于广西桂平境内浔江两岸。
浔江两岸高山夹峙，山势巍峨，犬牙交错，尤以大藤两岸附近的地势最为险峻恶劣。两岸之间有一条粗藤，身手敏捷的人可以攀附着这条大藤来回两岸。断藤峡上连八寨，下通仙台、花相诸洞，盘亘三百余里。
断藤峡土匪盘踞的地域相当于今天黔江、柳江、浔江流域的广大地区，涉及修仁、荔浦、上林、忻城等十多个区县。断藤峡中有上百个山洞，其中如仙人关、九层崖最为幽深险峻。断藤峡地区聚居着瑶、壮等少数民族和部分汉人，尤以瑶族为多。其中瑶族以蓝、胡、侯、盘四姓为主；山中又有善于用毒药弩矢的僮族。
明朝政府较早地在这一地区实行改土归流政策，用武力夺取瑶、僮族居民土地，又利用食盐垄断和专卖进行苛重剥削，终于激起断藤峡地区瑶、壮族民众的激烈反抗。
早在六十多年前的明宪宗成化元年（1465年），此处就发生了以侯大苟为首的大规模瑶族叛乱。他们把断藤峡当作基地，并建立数个寨子巩固基地，借着复杂地形与官军反复周旋。断藤峡叛乱的同时，当地有八座村寨即广西红水河南岸的思吉、周安、剥丁、古卯、罗墨、古钵、古蓬、都者等也开始造反。
那些生活在深山中的瑶民都有着矫健身手和凶蛮个性，走山路对他们来讲如走坦途，每一支弓箭都被他们用当地特产的毒药浸泡过，触之者不死即伤。八寨瑶民不仅凶蛮，更堪称狡猾。每当官军过来平叛，他们便谎称接受朝廷的招安；一旦官军离开，他们又恢复土匪本性，烧杀抢掠，为害一方。一时之间，广西境内烽烟四起，民不聊生。
明成化元年（1465年）十一月，巡抚都御史韩雍到大藤峡剿匪。韩雍是位文武双全的能臣，带领十万人马进入广西，从四面并进。这年十二月一日，韩雍在完成了对大藤峡的包围部署后，立即命令各路发起进攻。
战斗首先从山南打响。官兵登山强攻，匪贼用石头、标枪和毒矢齐发，打死打伤官兵无数。韩雍率兵夺取山南的石门、林峒、沙田、古营等要寨，大肆焚烧匪贼积聚的物资和房屋。侯大苟深感寡不敌众，遂率领义军边打边退，最后退至九层楼。
九层楼又名九层崖，位于桂平县罗渌三峒的上峒，（是一座山峦重叠，高有六七百米的高崖。）匪贼在此设置了多层木栅。韩雍见此哈哈一笑，想到了一个办法。他采取佯攻等诱使匪贼乱发矢石，同时派一支精兵从匪贼不备的地方登上山巅。等到匪贼矢石几乎用尽的时候，韩雍命令士兵四面攀缘进攻，同时登上山巅的官军发炮应援，上下夹攻，在山林中连日激烈交战。这时，韩雍巧用火攻烧山，呼声震天，山谷若崩。官军趁乱攻入山寨，生擒侯大苟及义军将士七百八十人，斩杀三千二百多人，一举**平大藤峡匪患。侯大苟被剥皮挖肠，凌迟处死。
当韩雍视察战场时发现了那根大藤，叛军正是凭借这根大藤在两岸悬崖峭壁间通行。他认为这根大藤是不祥之物，命人将其砍断，并改“大藤峡”名为“断藤峡”。他还在山崖上刻字记录自己的功劳。接下来，韩雍又率军扫灭了八寨叛贼，班师凯旋。
过了半个多世纪以后，断藤峡瑶民恢复元气，又开始袭扰峡外地区，各县不堪其扰。他们除了抢夺百姓、强抢民女，甚至连官府也敢抢占。他们视朝廷若无物，动辄就有官员丧命于其刀下。
明武宗正德五年（1510年），那根被砍断的大藤被造反的瑶民重新接上。于是断藤峡地区就又成了反叛的瑶民的基地，他们很快就控制了浔江上下数百里的广大地区。八寨紧跟其后，也死灰复燃，互相呼应，联手控制了黔江上下数百里的广大地区，上连八寨，下通仙台、花相等诸洞，联结数百余巢，盘亘三百余里。广西境内重新成为匪乱丛生、民生凋敝之地。
各地父老看到王阳明快速平定了思恩、田州叛乱，于是成群结队前来请求王阳明乘胜解决断藤峡的土匪。王阳明感觉到这事颇为复杂。此前，他居然都不知道广西境内还有这样一股力量雄厚的土匪，而朝廷对此也长期一无所知。
于是，他和部属们一起商议如何处置。王受和卢苏的意见是招抚他们，汪必东认为应该剿抚并用。王阳明却持强硬态度，认为他们“窃发无时，凶恶成性，不可改化”。断藤峡的盗匪曾多次被政府招安过，可他们屡降屡叛，已不可信任。
所以对待思恩、田州事件可以使用招抚手段，但对断藤峡的问题可能还是要用韩雍的铁血手段。这些骨子里流淌着反叛血液的匪盗，只有靠武力才能解决。否则官军一旦撤走，这些土匪肯定还是要卷土重来，一切心血都将付诸东流。
“破敌之计靠出奇制胜！”王阳明捋了捋胡须，确定好了平叛计策。他决意用兵，在这里打一场可控的、低烈度的局部战争。
嘉靖七年（1528年）四月二日，王阳明发兵进剿，命令湖广佥事汪溱、广西副使翁素、佥事吴天挺及参将张经、都指挥谢佩监湖广土兵，袭剿断藤峡叛军。此后仍然总督永顺兵进剿牛肠等寨，保靖兵进剿六寺等寨，约好以四月二日各自抵达指定地点。这次战役他主要采用的策略是“以蛮制蛮”，即利用湖广、贵州的永顺、保靖的苗兵，以及刚刚归顺的卢苏、王受的壮族士兵来进攻瑶民叛军，政府的正规军反而是起到领导和监督作用。
永顺、保靖的土司兵本是五代时期江西吉安刺史彭玕、彭瑊兄弟的后人，在宋初移民入湘，经过数百年发展，结合当地苗族彪悍的习性之后，成为明朝一支劲旅。永顺、保靖彭姓土司参与了众多战争。正德、嘉靖时期，永顺统兵宣慰彭明辅、彭宗舜父子，保靖统兵宣慰彭九霄、彭荩臣父子，辰州卫部押指挥彭飞等土司兵，都参加过王阳明平定赣州桶冈的战役，此次又奉调广西，参加断藤峡和八寨之战，立下赫赫战功。他们与王阳明建立了牢固的信任关系，每有征调，都是身先士卒，王阳明对彭氏土司兵的使用可以说是得心应手。
断藤峡和八寨的盗贼早就闻听过王阳明的大名，最初听说他来广西马上紧张起来，关闭寨门，深居简出。一个多月后，他们听说王阳明兵不血刃地收服了王受和卢苏，就更加惶惶不可终日。断藤峡缺粮多日，他们也不敢下山抢劫，只靠山中有限食物充饥。
王阳明制订了作战计划后，在南宁誓师，让八寨、断藤峡之匪非常紧张，后王阳明又有意向外界透露：他要在五日内对断藤峡和八寨采取军事行动。盗贼们更加紧张。五日过后，什么事都没有发生。他们去打探王阳明的情况时得知，王阳明正准备回浙江休养。几天后，盗贼们又得到消息说，王阳明正在南宁办学，他来广西的确就是对付思田王卢一伙的，根本就没有把断藤峡和八寨当作目标。于是，匪盗们又放下心来，看来不久官兵就会班师回朝了。
就这样虚虚实实，扑朔迷离，很快他们的末日就要到了。断藤峡之战起于嘉靖七年（1528年）四月二日，各路兵马到龙村埠登岸，以参将张经、指挥谢珮督同彭明辅等一千六百名土司兵，指挥马文瑞督同向永寿等一千二百名土司兵，指挥王勋督同彭九霄所部六百名土司兵，指挥唐宏督同彭九皋所部六百名土司兵，指挥卞琚督同彭辅等六百名土司兵，指挥张缙督同贾英所部六百名土司兵，千户刘宗本督同浔州、武靖等处新归降的壮族土兵一千名，于次日同时进攻，克期破敌。
四月三日，王阳明向早已部署完毕的两路指挥官发出了总攻令，这两路部队都在八千人以下，他们悄无声息地摸到了断藤峡和八寨的边缘。此时断藤峡土匪一方也得知了消息，首领胡缘二等人将家属尽数转移到大山中。官军各路兵马前来挑战时，断藤峡的瑶兵们毫无惧色，还利用自己熟悉地形的优势，主动发起进攻。这边各土司兵也“奋不顾身，冲突矢石，敌杀数合，贼锋摧败”。
断藤峡瑶民尽管背水一战，但也敌不过同样彪悍、训练有素的苗族、壮族土兵，很快溃败。叛军退守保仙女大山，依山势据险结营扎寨。政府军则攀木缘崖向上仰攻，连连攻破油榨、石壁、大陂等地，直逼断藤峡。然后官军开始放火烧山。当时正是七月炎夏，连绵起伏的森林郁郁葱葱。一旦放起火来，到处浓烟滚滚，断藤峡陷入烈火浓烟中，悍匪们晕头转向，斗志全无。到次年四月十日，断藤峡全面收复。
战斗进行到一半时，王阳明派士兵齐声高喊八寨土匪们已全部肃清，要断藤峡的匪盗们放下武器。果然，一听八寨已经被全歼，断藤峡的匪盗们的抵抗意志瞬间瓦解。他们一直向山顶溃逃，哭爹喊娘。王阳明同意他们投降，只要放下武器就会予以优待。
由于战前王阳明再三叮嘱不可妄杀，所以在断藤峡之战进行的八天当中，斩首只数百人，就宣布结束战斗，班师出峡，回到浔州。次日即四月十一日，王阳明再出师上林，袭破八寨。
八寨战役打响后，王受和卢苏率领五千敢死队猛攻八寨的前哨石门。石门不仅是八寨的前哨阵地，还是八寨门户。拿下石门，八寨的防御力量就会大大减弱。王受和卢苏二人刚刚归顺，此时急于立功，所以倾尽全力进攻。果然这二人不负众望，只用了半天时间就敲开了石门。
指挥官林富率领一千多人夺门而入，迅速推进到八寨的第一个寨子前。王受和卢苏依然担任主攻，林富按王阳明事先的指示，一面命王受和卢苏继续进攻，吸引住敌人的兵力，一面分兵从侧面进攻。与使用毒箭的两千余名瑶民对阵，结果对方也是一战即溃，仅斩首二百九十一人，第一寨很快被攻陷。
其他寨子虽然进行了抵抗，但不少寨子很快就缴械投降。不过，八寨最后的据点仍在顽强抵抗，尤其是他们看到断藤峡方向升起浓烟时，更是作起困兽之斗。王受和卢苏在这个关键时刻大喊：“杀啊！”“冲啊！”部队顶住压力，步步推进，最终将八寨全部攻下。
接下来，王阳明命令所有部队全力扫**各处巢穴的残余盗贼，将他们逼到了横水江。当时天下大雨，几千人争渡时翻船落水，被淹死者不计其数。大雨一连下了十多天。等到天晴时，官军再次搜山，眼前景象惨不忍睹：只见山洞中、绝壁下，横七竖八全是腐烂的尸首。
一个多月后，王阳明宣布断藤峡和八寨盗贼已全部消灭。断藤峡和八寨之战虽然准备仓促，时间也短，从战争的效果来看还是很不错的，阵亡少、代价小，也震慑了这一带的亡命之徒，使民族杂居区的形势趋于稳定。
王阳明上书举荐林富为都御史，巡抚该地，诸位将领均论功褒赏。
几个月后，当王阳明的报捷书传到北京时，朱厚熜感到有些怀疑：这王阳明看起来几乎是没费什么力气，就把别人根本完成不了的事给解决了。这样的“神操作”是不是有什么猫腻啊？这时朝中有人出于忌妒连进谗言，让朱厚熜竟认为王阳明的捷报“有失信义，近于夸诈，恩威倒置，恐伤大体”。
这时，有人挺身而出为王阳明辩护。礼部尚书方献夫、詹事府詹事霍韬上书给朱厚熜：王守仁不费斗米、不折一卒就平定了思田叛乱，还顺手拔除了八寨、断藤峡这样的积年老巢，整整为朝廷节省了数十万的人力物力！
王门弟子黄绾的上书更是言辞激烈：臣以为忠如守仁，有功如守仁，一屈于江西，讨平叛藩，却遭忌者诬为同谋，又诬其辇载金帛。当时大臣杨廷和等饰成其事，至今未白。若再屈于广西，恐怕劳臣灰心，将士解体，以后再有边患民变，谁还肯为国家出力，为陛下办事？
言者谆谆，听者藐藐。嘉靖皇帝淡淡地表示知道了，就再无下文。
随后，王阳明上书朝廷《处置八寨断藤峡以图永安疏》，就处置八寨、断藤峡善后问题提出了三条建议：
第一，把广西南丹卫所迁到八寨，以重兵震慑当地有异心的瑶民；
第二，把思恩府城迁到地势开阔、便于开展商业贸易的地方，让当地百姓从闭塞环境中走出来；
第三，各地县令深入乡村进行管理，以让行政权威抵达乡村，起到控制和监督作用。
然而，他的建议都未被朝廷重视和采纳。实际上，他对广西地方行政管理层面的建议根本没有人关心。
就这样，正所谓“飞鸟尽，良弓藏”，匪患既除，王阳明也就无足轻重了，甚至他取得的功绩都不再提了。还有那位大学士桂萼因恼怒王阳明没有继续解决安南问题，借机中伤说王阳明进剿八寨属擅自行动，越权行事，甚至要追究他的擅权之责。
远在万里之外的广西，王阳明也隐约感觉到了巨大的压力。但他没有时间考虑太多，日益虚弱的身体不允许他在这里多待一天。这时的王阳明终因过度劳累，一度晕厥过去，被人抬回南宁后身体更是每况愈下。
这时，他给一个学生写信说：“现在就想回去和你们在一起讲学论道；和亲人在一起，看看刚刚一岁多的儿子。”王阳明发妻诸氏始终没有生育。正德十年（1515年）王阳明过继表弟的儿子正宪接续香火。嘉靖四年（1525年）元月诸氏病故后，五十五岁的王阳明娶续弦张氏，后来生了个孩子，叫王正聪，后改名王正亿。孩子这时候还小，让王阳明颇为牵挂。
重病中的王阳明在平定匪患后，一心只想回家去，和亲人、弟子们团聚。