矛盾最终引发了战争,1821年,已经将大理人逐出广西的大粤向香港、澳门这两个小邦发出了合并邀请,港澳两城的刺史无力阻止北方强大邻国的诉求,他们宣布将在各自的城市举行公选,让两地的百姓决定自己州城的命运。公投的结果是两城绝大多数国人反对并入大粤帝国。这使得大粤皇帝何如灵大发雷霆,何如灵是一位拥有庞大野心的君主,他的本意是将岭南其余的三州一国(港、澳、琼和安南)通通纳入大粤帝国,珠江下游两个小邦的不识抬举彻底触怒了皇帝,7月1日,粤国外交大臣向两城发出最后通牒,要求他们主动并入帝国,但遭到拒绝。7月3日,粤国海陆军开进港澳两城,没有遭到抵抗,粤国宣布将两城彻底吞并。可是粤国万万没想到,这起毫不起眼的军事行动给南海带来了巨大的灾难。1821年8月23日吴越两国对广州发出最后通牒,要求粤军撤离并赔偿两城损失,粤国不予回应。很快,9月17日,吴越对大粤宣战,不久,10月1日,楚国(后楚)也宣布加入北方同盟,出兵岭南。粤国猝不及防,何如灵一方面命令海外省份自行抵抗,另一方面举国动员,开赴五岭抵抗。粤国对福州求援,但大闽因南方暴动宣布绝对中立,并禁止双方在闽国领土海域作战。吴越两国陆军由赣江南下进攻依附于大粤的胜国(客家人建立的国家,首都赣州),而联合海军主力开进珠江口求战,粤海军本土舰队出战不力躲入黄埔港,珠江口被封锁。11月,楚军攻入桂北,围困桂林城。1822年4月,吴越瀛洲联合部队攻占粤国多个殖民城市。6月,吴军在天涯角登陆,越国开始进攻西洋沿岸(桑巴给尔等地)。7月,桂林城被攻破,楚军沿西江直逼梧州,吴越联军进攻凌牙门(新加坡),被当地军民击退。12月,楚军攻破梧州,吴越联军攻克韶州,三国军队开进广州城郊,粤国被迫议和,于1824年1月签订《广州条约》,史称华南战争。