Mở màn 
Mặc dù Hiệp ước Sài Gòn 1874 cho phép tàu thuyền Pháp đi thám hiểm các dòng sông, nhưng tới những năm đầu 1880, quân Cờ đen của Lưu Vĩnh Phúc tiếp tục quấy nhiễu và cản trở các thương gia Pháp. Hệ quả là chính quyền Pháp phái một lực lượng viễn chinh nhỏ với nhiệm vụ quét sạch quân Cờ đen khỏi vùng đồng bằng sông Hồng. Quân Pháp nhanh chóng đánh chiếm thành Hà Nội và chuẩn bị tiễu trừ các lực lượng quân sự chống đối họ, bao gồm quân của triều đình Huế do Phò mã Hoàng Kế Viêm quản lĩnh và quân Cờ đen của Lưu Vĩnh Phúc. Nhà Thanh vốn luôn phản đối sự hiện diện của Pháp trên Bắc kỳ liền bắt đầu chuẩn bị chiến tranh. Lấy cớ tiễu trừ thổ phỉ, quân đội Vân Nam và Lưỡng Quảng (Quảng Đông và Quảng Tây) được điều động tiến sát về biên giới, sẵn sàng vượt biên giới tiến sang Bắc kỳ. Nhà Thanh cũng hạ lệnh cho hải đội Quảng Đông, gồm 20 thuyền tiến vào hải phận của Việt Nam để thị uy. Tới ngày 17 tháng 6 năm 1882, quân Thanh từ Vân Nam do Tạ Kính Bưu, Đường Cảnh Tùng chỉ huy vượt biên giới tràn sang Bắc Việt, đóng ở Bắc Ninh và ở Sơn Tây, có quan bố chính Quảng Tây là Từ Diên Húc đem quân sang tiếp ứng, phối hợp với các lực lượng tiền tiêu đã đồn trú tại Bắc Việt từ tháng 8 năm 1881, để hỗ trợ cho quân Nam của Hoàng Kế Viêm và quân Cờ đen của Lưu Vĩnh Phúc.