登録完了画面でブラウザを更新すると「フォームを再送信しますか」と聞かれ、同じ申請が二件できた。ここでボタンを押せなくするJavaScriptを足しても、通信再試行や別タブからの送信は止まりません。
対策は、どの再送を止めたいかで選びます。正常なPOSTの後に結果ページへ移動させるPRG(Post/Redirect/Get)は、更新時の再送を減らす第一歩です。しかし二つのPOSTが同時に届く場合は、サーバー側の仕組みも必要です。以下は Java 21、Spring Boot 3.5系の架空の申請フォームです。
実行用サンプル
PRGで同じGETを繰り返す場合、同じPOSTを再送する場合、一意制約で同時POSTを止める場合を同じDBで比較します。 JDK 17とMaven 3.9系で mvn test を実行できます。ZIPにはソース全文・テスト・pom.xml・READMEを収録しています。
「二重送信」を三つに分ける

| 起点 | 何が起きるか | 主な対策 |
|---|---|---|
| POST結果画面を更新 | ブラウザが直前のPOSTを再送しようとする | 成功後にPRG |
| ボタンを素早く2回押す | 二つのPOSTが結果を見る前に届く | UI抑止に加え、サーバーで同一操作を識別 |
| 応答前にタイムアウトし再試行 | 保存は成功したのに利用者には失敗に見える | 冪等キーなどで同じ操作の結果を返す |
画面のボタン無効化は操作感には役立ちますが、整合性を保証する場所ではありません。重複が金銭・在庫・通知に関わるなら、ブラウザに任せず保存側で担保します。
成功時はPRGにする
保存後にテンプレート名を返すと、現在のページがPOSTの結果になります。成功後に redirect: を返し、詳細画面をGETで開けば、そこで更新してもGETが繰り返されます。
RequestPageController.java の全文
package info.syachiku.audit;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.mvc.support.RedirectAttributes;
@Controller
class RequestPageController {
private final RequestService service;
RequestPageController(RequestService service) {
this.service = service;
}
@PostMapping("/requests")
String create(@ModelAttribute RequestForm form, RedirectAttributes redirect) {
long id = service.create(form);
redirect.addFlashAttribute("notice", "申請を登録しました");
return "redirect:/requests/" + id;
}
@PostMapping("/requests/once")
String createOnce(@ModelAttribute RequestForm form, RedirectAttributes redirect) {
long id = service.createOnce(form);
redirect.addFlashAttribute("notice", "申請を登録しました");
return "redirect:/requests/" + id;
}
@GetMapping("/requests/{id}")
String detail(@PathVariable long id, Model model) {
model.addAttribute("request", service.find(id));
return "requests/detail";
}
}RequestService、RequestForm と詳細画面テンプレートの全文を配布ZIPに収録しています。flashAttribute はリダイレクト先で一度表示する通知に使います。登録内容や機密値をURLのクエリに載せる用途ではありません。入力エラー時にどう画面へ戻すかは別に設計し、成功したPOSTだけをこの詳細GETへ移します。
PRGだけで止まらない二件を再現する
テストの /requests は302を返します。リダイレクト先を2回GETしても保存は1件です。同じPOSTを2回送ると保存は2件です。/requests/once では、同じキー・同じ内容を同時に送ると、両方が同じ詳細URLを指して保存は1件です。同じキーで異なる内容を送ると409になります。
RequestService.java の全文
package info.syachiku.audit;
import org.springframework.dao.DataIntegrityViolationException;
import org.springframework.http.HttpStatus;
import org.springframework.stereotype.Service;
import org.springframework.web.server.ResponseStatusException;
@Service
public class RequestService {
private final RequestSubmissionRepository repository;
RequestService(RequestSubmissionRepository repository) {
this.repository = repository;
}
long create(RequestForm form) {
return repository.save(new RequestSubmission(null, form.title())).getId();
}
long createOnce(RequestForm form) {
String key = form.requestKey();
if (key == null || key.isBlank()) {
throw new ResponseStatusException(HttpStatus.BAD_REQUEST, "申請キーがありません");
}
try {
return repository.saveAndFlush(new RequestSubmission(key, form.title())).getId();
} catch (DataIntegrityViolationException failure) {
// The repository's failed insert has already rolled back.
RequestSubmission saved = repository.findByRequestKey(key).orElseThrow(() -> failure);
if (!saved.getTitle().equals(form.title())) {
throw new ResponseStatusException(HttpStatus.CONFLICT, "同じキーの申請内容が異なります");
}
return saved.getId();
}
}
RequestSubmission find(long id) {
return repository.findById(id)
.orElseThrow(() -> new ResponseStatusException(HttpStatus.NOT_FOUND));
}
}RequestPageControllerTest.java の全文
package info.syachiku.audit;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Executors;
import java.util.concurrent.TimeUnit;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@SpringBootTest
@AutoConfigureMockMvc
class RequestPageControllerTest {
@Autowired
private MockMvc mvc;
@Autowired
private RequestSubmissionRepository repository;
@BeforeEach
void clear() {
repository.deleteAll();
}
@Test
void リダイレクト先を二度GETしても一件のまま() throws Exception {
String location = submit("/requests", "A", "申請A");
mvc.perform(get(location)).andExpect(status().isOk());
mvc.perform(get(location)).andExpect(status().isOk());
assertEquals(1, repository.count());
}
@Test
void 同じ内容を二度POSTするとPRGだけでは二件保存される() throws Exception {
submit("/requests", "A", "申請A");
submit("/requests", "A", "申請A");
assertEquals(2, repository.count());
}
@Test
void 同じキーの同時POSTは同じ申請を指しDBに一件残る() throws Exception {
var start = new CountDownLatch(1);
var ready = new CountDownLatch(2);
var executor = Executors.newFixedThreadPool(2);
try {
var first = executor.submit(() -> submitTogether(start, ready));
var second = executor.submit(() -> submitTogether(start, ready));
org.junit.jupiter.api.Assertions.assertTrue(ready.await(5, TimeUnit.SECONDS));
start.countDown();
assertEquals(first.get(10, TimeUnit.SECONDS), second.get(10, TimeUnit.SECONDS));
} finally {
executor.shutdownNow();
}
assertEquals(1, repository.count());
}
@Test
void キーを再利用して内容を変えたら409になる() throws Exception {
submit("/requests/once", "A", "申請A");
mvc.perform(post("/requests/once").param("requestKey", "A").param("title", "別の申請"))
.andExpect(status().isConflict());
assertEquals(1, repository.count());
}
private String submitTogether(CountDownLatch start, CountDownLatch ready) throws Exception {
ready.countDown();
org.junit.jupiter.api.Assertions.assertTrue(start.await(5, TimeUnit.SECONDS));
return submit("/requests/once", "A", "申請A");
}
private String submit(String path, String key, String title) throws Exception {
return mvc.perform(post(path).param("requestKey", key).param("title", title))
.andExpect(status().isFound())
.andReturn().getResponse().getRedirectedUrl();
}
}テストでは、まず保存処理への同じPOSTを二回送ります。両方のリクエストが保存を呼べば、PRGの後で二つの詳細URLへ移るだけです。結果ページを更新して問題が消えても、ボタン連打の問題が残る理由はここにあります。
同じ操作を一度だけ成立させたいなら、フォーム表示時に操作IDを発行し、POSTで送ります。保存側に request_key の一意制約を設け、同じキーの二度目は新規保存せず既存の結果へ案内します。実装時は、キーをどの利用者・操作へ結び付けるか、失敗時に再利用できるか、保存とキー記録を同じトランザクションにするかまで決めます。単純にセッションの「使用済み」フラグを見るだけでは、同時リクエストの競合に弱い場合があります。
業務上「顧客IDと対象月の申請は一件だけ」と決まっているなら、その組み合わせのDB一意制約も有効です。ただし業務キーの一意制約は、別件として二件作れる業務での連打対策とは意味が違います。操作の重複と業務データの重複を混ぜないことです。
確認する順番
- 登録後のURLが詳細GETへ変わり、更新しても件数が増えないか。
- 同じPOSTを二回送ったとき、件数が増えるか。
- 同じ操作IDを同時に送ったとき、一件だけ成立するか。
- 保存成功・応答失敗の後に再試行して、利用者へ既存結果を返せるか。
最初の一項目しか試さないと、PRGの成功を「二重登録を完全に防いだ」と誤認します。まず更新による再送を直し、重複が許されない操作には保存側の保証を加えてください。
